Rust MCP SDK

Quick Start

Add to your Cargo.toml:

[dependencies]
rust-mcp-sdk = "0.9.0"  # Check crates.io for the latest version

Usage Examples

👉 For more examples (stdio, Streamable HTTP, clients, auth, etc.), see the examples/ directory.

👉 If you are looking for a step-by-step tutorial on how to get started with rust-mcp-sdk , please see : Getting Started MCP Server

See hello-world-mcp-server-stdio example running in MCP Inspector :

<img src="assets/examples/hello-world-mcp-server.gif" alt="hello world mcp server in rust" width="800" />

AxumServerOptions

AxumServer is a lightweight Axum-based server provided by the rust-mcp-axum crate that streamlines MCP servers by supporting Streamable HTTP and SSE transports. It supports simultaneous client connections, internal session management, and includes built-in security features like DNS rebinding protection and more.

AxumServer is highly customizable through AxumServerOptions provided during initialization.

A typical example of creating an AxumServer that exposes the MCP server via Streamable HTTP and SSE transports at:

let server = create_axum_server(
    server_details,
    handler.to_mcp_server_handler(),
    AxumServerOptions {
        host: "127.0.0.1".to_string(),
        port: 8080,
        event_store: Some(std::sync::Arc::new(InMemoryEventStore::default())), // enable resumability
        auth: Some(Arc::new(auth_provider)), // enable authentication
        sse_support: false,
        ..Default::default()
    },
);

server.start().await?;

📝 Refer to AxumServerOptions for a complete overview of AxumServerOptions attributes and options.

Rust MCP SDK

<img alt="crates.io" src="https://img.shields.io/crates/v/rust-mcp-sdk?style=for-the-badge&logo=rust&color=FE965D" height="22"> <img alt="docs.rs" src="https://img.shields.io/badge/docs.rs-rust_mcp_SDK-0ECDAB?style=for-the-badge&logo=docs.rs" height="22"> <img alt="build status" src="https://img.shields.io/github/actions/workflow/status/rust-mcp-stack/rust-mcp-sdk/ci.yml?style=for-the-badge" height="22"> <img alt="Hello World MCP Server" src="https://img.shields.io/badge/Example-Hello%20World%20MCP-0286ba?style=for-the-badge&logo=rust" height="22">

A high-performance, asynchronous Rust toolkit for building MCP servers and clients. Focus on your application logic - rust-mcp-sdk handles the protocol, transports, and the rest! This SDK fully implements the latest MCP protocol version (2025-11-25), with backward compatibility built-in. rust-mcp-sdk provides the necessary components for developing both servers and clients in the MCP ecosystem. It leverages the rust-mcp-schema crate for type-safe schema objects and includes powerful procedural macros for tools and user input elicitation.

Health Check Endpoint

While not part of the official MCP spec, rust-mcp-sdk provides an optional HTTP health check endpoint. This is a practical quality-of-life feature, specifically useful when your MCP server is: - Exposed behind load balancers or reverse proxies (e.g., NGINX, HAProxy, Cloudflare). - Running in container orchestration environments (e.g., Kubernetes, Docker Swarm, AWS ECS).

The health check endpoint is disabled by default. You can enable it and optionally provide your own custom handler (to return specific metrics or metadata) via AxumServerOptions:

let server = create_axum_server(
    server_details,
    handler.to_mcp_server_handler(),
    AxumServerOptions {
        host: "127.0.0.1".into(),
        health_endpoint: Some("/health".into()),             // enables the endpoint
        health_handler: Some(Arc::new(CustomHealth {})),     // optional: overrides default 200 OK
        ..Default::default()
    },
);

👉 See the streamable_http_healthcheck.rs example for a complete implementation demonstrating a custom JSON health handler.

Projects using Rust MCP SDK

Below is a list of projects that utilize the rust-mcp-sdk, showcasing their name, description, and links to their repositories or project pages.