mcpkit-actix

Actix-web integration for the Model Context Protocol (MCP).

This crate provides integration between the MCP SDK and the Actix-web framework, making it easy to expose MCP servers over HTTP.

Features

• HTTP POST endpoint for JSON-RPC messages
• Server-Sent Events (SSE) streaming for notifications
• Session management with automatic cleanup
• Protocol version validation
• CORS support

Usage

use mcpkit_actix::McpRouter;
use mcpkit_server::ServerHandler;

// Your MCP server handler (must implement ServerHandler, ToolHandler, etc.)
// Note: Clone is NOT required - the handler is wrapped in Arc internally.
struct MyServer;

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    // Simplest approach: use McpRouter for stdio-like ergonomics
    McpRouter::new(MyServer)
        .with_cors()
        .with_logging()
        .serve("0.0.0.0:3000")
        .await
}

Default Endpoints

Customizing Paths

McpRouter::new(MyServer)
    .post_path("/api/mcp")
    .sse_path("/api/mcp/sse")
    .serve("0.0.0.0:3000")
    .await

Integration with Existing App

For more control, integrate MCP routes into an existing Actix-web application:

use mcpkit_actix::McpRouter;
use mcpkit_server::ServerHandler;
use actix_web::{App, HttpServer};

struct MyServer;

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    let router = McpRouter::new(MyServer);

    HttpServer::new(move || {
        App::new()
            .configure(router.configure_app())
            // Add your other routes here
    })
    .bind("0.0.0.0:3000")?
    .run()
    .await
}

Exports

Part of mcpkit

This crate is part of the mcpkit SDK. For most use cases, depend on mcpkit directly rather than this crate.

License

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