Crate rmcp

The official Rust SDK for the Model Context Protocol (MCP).

The MCP is a protocol that allows AI assistants to communicate with other services. rmcp is the official Rust implementation of this protocol.

There are two ways in which the library can be used, namely to build a server or to build a client.

Server

A server is a service that exposes capabilities. For example, a common use-case is for the server to make multiple tools available to clients such as Claude Desktop or the Cursor IDE.

For example, to implement a server that has a tool that can count, you would make an object for that tool and add an implementation with the #[tool_router] macro:

use std::sync::Arc;
use rmcp::{Error as McpError, model::*, tool, tool_router, handler::server::tool::ToolRouter};
use tokio::sync::Mutex;

#[derive(Clone)]
pub struct Counter {
    counter: Arc<Mutex<i32>>,
    tool_router: ToolRouter<Self>,
}

#[tool_router]
impl Counter {
    fn new() -> Self {
        Self {
            counter: Arc::new(Mutex::new(0)),
            tool_router: Self::tool_router(),
        }
    }

    #[tool(description = "Increment the counter by 1")]
    async fn increment(&self) -> Result<CallToolResult, McpError> {
        let mut counter = self.counter.lock().await;
        *counter += 1;
        Ok(CallToolResult::success(vec![Content::text(
            counter.to_string(),
        )]))
    }
}

Next also implement ServerHandler for Counter and start the server inside main by calling Counter::new().serve(...). See the examples directory in the repository for more information.

Client

A client can be used to interact with a server. Clients can be used to get a list of the available tools and to call them. For example, we can uv to start a MCP server in Python and then list the tools and call git status as follows:

use anyhow::Result;
use rmcp::{model::CallToolRequestParam, service::ServiceExt, transport::{TokioChildProcess, ConfigureCommandExt}};
use tokio::process::Command;

async fn client() -> Result<()> {
    let service = ().serve(TokioChildProcess::new(Command::new("uvx").configure(|cmd| {
        cmd.arg("mcp-server-git");
    }))?).await?;

    // Initialize
    let server_info = service.peer_info();
    println!("Connected to server: {server_info:#?}");

    // List tools
    let tools = service.list_tools(Default::default()).await?;
    println!("Available tools: {tools:#?}");

    // Call tool 'git_status' with arguments = {"repo_path": "."}
    let tool_result = service
        .call_tool(CallToolRequestParam {
            name: "git_status".into(),
            arguments: serde_json::json!({ "repo_path": "." }).as_object().cloned(),
        })
        .await?;
    println!("Tool result: {tool_result:#?}");

    service.cancel().await?;
    Ok(())
}

Re-exports

pub use handler::client::ClientHandler;client

pub use handler::server::ServerHandler;server

pub use service::Peer;client or server

pub use service::Service;client or server

pub use service::ServiceError;client or server

pub use service::ServiceExt;client or server

pub use service::RoleClient;client

pub use service::serve_client;client

pub use service::RoleServer;server

pub use service::serve_server;server

pub use schemars;macros and server

pub use serde;macros

pub use serde_json;macros

Modules

handler

model

Basic data types in MCP specification

serviceclient or server

transport

Transport

Macros

const_string

objectmacros

Use this macro just like serde_json::json!

pastemacros and server

Type Aliases

Error

Attribute Macros

toolmacros and server

tool

tool_handlermacros and server

tool_handler

tool_routermacros and server

tool_router