Reorganise?

[itsaphel]

May I gently suggest moving crates/mcp-client and crates/mcp-server to the examples directory? As they seem to be like sample implementations one could use, but are not actually part of the library as far as I can tell.

[jlvihv]

Can someone come out and say a word? I agree with you. And it seems that the Router / Server / ByteTransport / BoundedService in crates/mcp-server and those defined errors should be moved to core to give the user a cleaner and leaner code example, can we do anything for this repository?

[baxen]

The mcp-client and mcp-server are intended to be the dependencies that downstream crates would use directly! mcp-core is for shared content between both, mostly the types used in messages. The intent is that you can grab either client or server depending on what you need

[AdamSimpson]

Just wanted to gently third that I find this repo quite confusing. As a rust developer I find offeryn has a familiar layout, with a top level examples directory containing projects demonstrating how to use the crate. I've spent a few minutes looking at #8 and am honestly still not quite sure how to use this library efficiently.

[baxen]

Yes we're overdue for examples and documentation! The layout across a few crates (similar to offeryn) I think is somewhat necessary, but we'll add top level examples to make this clear

[itsaphel]

Shouldn't https://github.com/modelcontextprotocol/rust-sdk/blob/main/crates/mcp-server/src/main.rs at least be an example, since it's a particular usage of an mcp-server (a counter server), showing how the library should be used?

[WSL0809]

Yes we're overdue for examples and documentation! The layout across a few crates (similar to offeryn) I think is somewhat necessary, but we'll add top level examples to make this clear是的，我们确实需要提供示例和文档了！虽然跨多个 crate 的布局（类似于 offeryn ）是必要的，但我们会添加顶层示例来让这一点更加清晰

I completely agree with clearly documenting the project's examples and roadmap in the README.

[baxen]

Pausing this reorganization for a second so we can coordinate several other MCP builders who have reached out