Crate mcp_protocol_sdk

Expand description

§MCP Rust SDK (2025-03-26)

A comprehensive Rust SDK for the Model Context Protocol (MCP) version 2025-03-26, providing both server and client implementations with full MCP specification compliance including audio content, annotations, and enhanced capabilities.

§Features

🚀 High Performance: Built with Rust’s zero-cost abstractions and async/await
🛡️ Type Safety: Leverages Rust’s type system to prevent runtime errors
🔌 Multiple Transports: Support for STDIO, HTTP/SSE, and WebSocket transports
🎯 Full MCP 2025-03-26 Compliance: Complete implementation of the latest MCP specification
📚 Rich Ecosystem: Tools, resources, prompts, and sampling support
🎵 Audio Support: NEW in 2025-03-26 - Audio content support for multimodal interactions
🏷️ Annotations: NEW in 2025-03-26 - Tool and content annotations for enhanced metadata
🔧 Autocompletion: NEW in 2025-03-26 - Argument autocompletion capabilities
📁 Roots Support: NEW in 2025-03-26 - File system roots for enhanced resource access

§Quick Start

§Server Example

use mcp_protocol_sdk::{
    server::McpServer,
    core::{tool::ToolHandler, error::McpResult},
    protocol::types::{Content, CallToolResult},
};
use async_trait::async_trait;
use std::collections::HashMap;
use serde_json::Value;

struct EchoHandler;

#[async_trait]
impl ToolHandler for EchoHandler {
    async fn call(&self, arguments: HashMap<String, Value>) -> McpResult<CallToolResult> {
        let message = arguments.get("message")
            .and_then(|v| v.as_str())
            .unwrap_or("Hello, World!");
         
        Ok(CallToolResult {
            content: vec![Content::text(message)],
            is_error: Some(false),
            meta: None,
        })
    }
}

#[tokio::main]
async fn main() -> McpResult<()> {
    let mut server = McpServer::new("echo-server".to_string(), "1.0.0".to_string());
     
    server.add_tool(
        "echo".to_string(),
        Some("Echo a message".to_string()),
        serde_json::json!({
            "type": "object",
            "properties": {
                "message": { "type": "string" }
            }
        }),
        EchoHandler,
    ).await?;
     
    Ok(())
}

§Module Organization

core: Core abstractions for resources, tools, prompts, and errors
protocol: MCP protocol types and message definitions (2025-03-26)
transport: Transport layer implementations (STDIO, HTTP, WebSocket)
server: MCP server implementation and lifecycle management
client: MCP client implementation and session management
utils: Utility functions and helpers

Re-exports§

pub use core::error::McpError;
pub use core::error::McpResult;
pub use protocol::types::*;

Modules§

client: MCP client implementation
core: Core abstractions and types for the MCP SDK
prelude: Prelude module for convenient imports (2025-03-26)
protocol: MCP protocol implementation (2025-03-26)
server: MCP server implementation
transport: Transport layer implementations
utils: Utility functions and helpers for the MCP Rust SDK

Macros§

tool: Helper macro for creating tools with schema validation

Crate mcp_protocol_sdkCopy item path