mcpcpp - C++ Model Context Protocol Library

A modern C++ implementation of the Model Context Protocol (MCP) for building AI-powered applications with external tool integration.

🚀 Features

• ✅ Full MCP Protocol Support - JSON-RPC 2.0 based protocol (v2024-11-05)
• ✅ Dual Transport - STDIO and SSE/HTTP modes
• ✅ Tools - Register C++ functions as AI-callable tools
• ✅ Resources - Serve data, configurations, and files
• ✅ Prompts - Provide reusable prompt templates
• ✅ Client Library - Connect to MCP servers from C++
• ✅ Dynamic Configuration - Load tools from JSON config files
• ✅ Header-Only Option - Easy integration
• ✅ Modern C++17 - Type-safe and efficient

📦 Quick Start

Installation

git clone https://github.com/nlpresearchai/mcpcpp.git
cd mcpcpp
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build .
sudo cmake --install .

Basic Usage

#include 

int main() {
    // Create server
    mcp::MCPServer server("my-server", "1.0.0");
    
    // Add a tool
    server.add_tool(
        "add",
        "Add two numbers",
        {
            {"type", "object"},
            {"properties", {
                {"a", {{"type", "number"}}},
                {"b", {{"type", "number"}}}
            }},
            {"required", {"a", "b"}}
        },
        [](const json& args) -> json {
            return {{"result", args["a"].get() + args["b"].get()}};
        }
    );
    
    // Run server (STDIO mode)
    server.run_stdio();
    
    return 0;
}

Using in Your Project

CMakeLists.txt:

find_package(cppmcp REQUIRED)

add_executable(my_server main.cpp)
target_link_libraries(my_server PRIVATE cppmcp::cppmcp)

📚 Documentation

Core Components

1. MCP Server (mcp_server.hpp)

Create servers that expose tools, resources, and prompts to AI applications.

mcp::MCPServer server("server-name", "1.0.0");

// Add tool
server.add_tool("tool_name", "description", input_schema, 
    [](const json& args) { return result; });

// Add resource
server.add_resource("uri://resource", "name", "description", "mime-type",
    []() { return "data"; });

// Add prompt
server.add_prompt("prompt_name", "description", arguments,
    [](const json& args) { return prompt; });

// Run
server.run_stdio();  // or server.run_sse(port);

2. MCP Client (mcp_client.hpp)

Connect to MCP servers and call tools.

mcp::MCPClient client("client-name", "1.0.0");

// Connect
client.connect_sse("http://localhost:8080");
client.initialize();

// List and call tools