modelcontextprotocol/rust-sdk
Watch
1
0
Fork
You've already forked rust-sdk
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

feat(macros): auto-generate get_info and default router (#785)

Browse source 
* feat(macros): auto-generate get_info and default router

* docs: simplify examples and docs with new defaults

* feat(macros): add tool_router(server_handler) to elide separate #[tool_handler] impl

* docs: add Tools section to README and simplify calculator examples with server_handler
This commit is contained in:
Dale Seo 2026-04-08 15:06:26 -04:00 • committed by GitHub
commit be321a4abe
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 742 additions and 233 deletions
Download patch file Download diff file Expand all files Collapse all files

31
crates/rmcp-macros/README.md
View file

@ -20,7 +20,7 @@ For **getting started** and **full MCP feature documentation**, see the [main RE
| Macro | Description |
|-------|-------------|
| [`#[tool]`][tool] | Mark a function as an MCP tool handler |
| [`#[tool_router]`][tool_router] | Generate a tool router from an impl block |
| [`#[tool_router]`][tool_router] | Generate a tool router from an impl block (optional `server_handler` flag elides a separate `#[tool_handler]` block for tools-only servers) |
| [`#[tool_handler]`][tool_handler] | Generate `call_tool` and `list_tools` handler methods |
| [`#[prompt]`][prompt] | Mark a function as an MCP prompt handler |
| [`#[prompt_router]`][prompt_router] | Generate a prompt router from an impl block |
@ -37,13 +37,30 @@ For **getting started** and **full MCP feature documentation**, see the [main RE
## Quick Example
Tools-only server with a single `impl` block (`server_handler` expands `#[tool_handler]` in a second macro pass):
```rust,ignore
use rmcp::{tool, tool_router, tool_handler, ServerHandler, model::*};
use rmcp::{tool, tool_router};
#[derive(Clone)]
struct MyServer {
tool_router: rmcp::handler::server::tool::ToolRouter<Self>,
struct MyServer;
#[tool_router(server_handler)]
impl MyServer {
#[tool(description = "Say hello")]
async fn hello(&self) -> String {
"Hello, world!".into()
}
}
```
If you need custom `#[tool_handler(...)]` arguments (e.g. `instructions`, `name`, or stacked `#[prompt_handler]` on the same `impl ServerHandler`), use two blocks instead:
```rust,ignore
use rmcp::{tool, tool_router, tool_handler, ServerHandler};
#[derive(Clone)]
struct MyServer;
#[tool_router]
impl MyServer {
@ -54,11 +71,7 @@ impl MyServer {
}
#[tool_handler]
impl ServerHandler for MyServer {
fn get_info(&self) -> ServerInfo {
ServerInfo::default()
}
}
impl ServerHandler for MyServer {}
```
See the [full documentation](https://docs.rs/rmcp-macros) for detailed usage of each macro.