model-context-protocol-macros 0.1.3

Procedural macros for MCP server and tool definitions
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

# MCP Macros

Procedural macros for the Model Context Protocol (MCP) Rust implementation.

## Features

This crate provides procedural macros to reduce boilerplate when defining MCP servers:

- `#[mcp_server]` - Define server metadata and collect tools
- `#[mcp_tool]` - Mark a method as an MCP tool
- `#[mcp_internal]` - Mark a server as built-in (no stdio wrapper)

## Usage

```rust
use mcp::macros::{mcp_server, mcp_tool};
use mcp::ToolResult;
use serde_json::Value;

#[mcp_server(name = "calculator", version = "1.0.0")]
pub struct CalculatorServer;

#[mcp_server]
impl CalculatorServer {
    #[mcp_tool(description = "Add two numbers")]
    pub fn add(&self, a: f64, b: f64) -> ToolResult<f64> {
        Ok(a + b)
    }
    
    #[mcp_tool(description = "Multiply two numbers")]
    pub fn multiply(&self, a: f64, b: f64) -> ToolResult<f64> {
        Ok(a * b)
    }
}
```

## Parameter Documentation

Tool parameters can be documented using doc comments:

```rust
#[mcp_tool(description = "Store a value in memory")]
pub fn memory_write(
    &self,
    /// The scope/namespace for the memory
    scope: String,
    /// The key to store the value under
    key: String,
    /// The value to store (can be any JSON value)
    value: Value,
) -> ToolResult<String> {
    // implementation
}
```

## License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.