Mcpcpp

🚀 mcpcpp - C++ 模型上下文協議庫

mcpcpp 是 模型上下文協議 (MCP) 的現代 C++ 實現，用於構建集成外部工具的人工智能應用程序。它基於 JSON-RPC 2.0 協議，支持多種傳輸模式，能輕鬆集成到 C++ 項目中。

🚀 快速開始

📦 安裝

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

💻 基礎用法

#include <cppmcp/mcp_server.hpp>

int main() {
    // 創建服務器
    mcp::MCPServer server("my-server", "1.0.0");
    
    // 添加工具
    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<double>() + args["b"].get<double>()}};
        }
    );
    
    // 運行服務器（STDIO 模式）
    server.run_stdio();
    
    return 0;
}

在項目中使用

CMakeLists.txt:

find_package(cppmcp REQUIRED)

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

✨ 主要特性

• ✅ 完整的 MCP 協議支持 - 基於 JSON-RPC 2.0 的協議（v2024-11-05）
• ✅ 雙傳輸模式 - 支持 STDIO 和 SSE/HTTP 模式
• ✅ 工具集成 - 可將 C++ 函數註冊為 AI 可調用的工具
• ✅ 資源服務 - 提供數據、配置和文件服務
• ✅ 提示模板 - 提供可複用的提示模板
• ✅ 客戶端庫 - 可從 C++ 連接到 MCP 服務器
• ✅ 動態配置 - 從 JSON 配置文件加載工具
• ✅ 僅頭文件選項 - 易於集成
• ✅ 現代 C++17 - 類型安全且高效

📚 詳細文檔

核心組件

1. MCP 服務器 (mcp_server.hpp)

創建向 AI 應用程序公開工具、資源和提示的服務器。

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

// 添加工具
server.add_tool("tool_name", "description", input_schema, 
    [](const json& args) { return result; });

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

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

// 運行
server.run_stdio();  // 或 server.run_sse(port);

2. MCP 客戶端 (mcp_client.hpp)

連接到 MCP 服務器並調用工具。

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

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

// 列出並調用工具
auto tools = client.list_tools();
auto result = client.call_tool("add", {{"a", 5}, {"b", 3}});

// 讀取資源
auto resources = client.list_resources();
auto data = client.read_resource("config://app");

3. 動態服務器 (dynamic_mcp_server.hpp)

從 JSON 文件加載服務器配置。

#include <cppmcp/dynamic_mcp_server.hpp>

dynamic_mcp::ConfigLoader loader("tasks_config.json");
loader.load();

// 服務器會根據 JSON 自動配置

📖 使用示例

查看 目錄：

• simple_server.cpp - 最小的 MCP 服務器
• server_with_tools.cpp - 包含多個工具、資源和提示的服務器
• dynamic_server.cpp - 基於配置驅動的服務器
• client_example.cpp - MCP 客戶端的使用

構建示例

cd build
cmake .. -DCPPMCP_BUILD_EXAMPLES=ON
cmake --build .
./examples/simple_server stdio
./examples/server_with_tools sse 8080

🏗️ 項目結構

mcpcpp/
├── include/cppmcp/          # 公共頭文件
│   ├── mcp_server.hpp       # 服務器 API
│   ├── mcp_client.hpp       # 客戶端 API
│   └── dynamic_mcp_server.hpp  # 動態配置
├── src/                     # 實現代碼
│   ├── mcp_server.cpp
│   ├── mcp_sse.cpp
│   ├── mcp_client.cpp
│   └── dynamic_mcp_server.cpp
├── examples/                # 使用示例
├── tests/                   # 單元測試
├── docs/                    # 文檔
└── CMakeLists.txt          # 構建配置

🛠️ 構建

要求

• C++17 編譯器（GCC 7+、Clang 5+、MSVC 2017+）
• CMake 3.14+
• libcurl（用於 HTTP/SSE 支持）

依賴項（由 CMake 自動獲取）：

• nlohmann/json - JSON 解析
• cpp-httplib - HTTP 服務器

CMake 選項

-DCPPMCP_BUILD_EXAMPLES=ON   # 構建示例（默認：ON）
-DCPPMCP_BUILD_TESTS=ON      # 構建測試（默認：ON）
-DCPPMCP_BUILD_SHARED=ON     # 構建共享庫（默認：ON）
-DCPPMCP_BUILD_STATIC=ON     # 構建靜態庫（默認：ON）

Ubuntu/Debian

sudo apt-get install build-essential cmake libcurl4-openssl-dev

macOS

brew install cmake curl

🧪 測試

cd build
cmake .. -DCPPMCP_BUILD_TESTS=ON
cmake --build .
ctest

🔌 與 AI 客戶端集成

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "cppmcp-example": {
      "command": "/path/to/build/examples/simple_server",
      "args": ["stdio"]
    }
  }
}

自定義 Python 客戶端

import httpx
import json

# 連接到 SSE 服務器
response = httpx.post(
    "http://localhost:8080/message",
    json={
        "jsonrpc": "2.0",
        "id": 1,
        "method": "initialize",
        "params": {
            "protocolVersion": "2024-11-05",
            "capabilities": {},
            "clientInfo": {"name": "python-client", "version": "1.0"}
        }
    }
)
print(response.json())

📊 性能

• 低延遲 - 直接的 C++ 執行，無 Python 開銷
• 高吞吐量 - 每秒可處理數千個請求
• 內存高效 - 最小化內存分配，優化數據結構
• 異步就緒 - 支持非阻塞 SSE 連接

🤝 貢獻

歡迎貢獻代碼！請按照以下步驟操作：

1. 分叉倉庫
2. 創建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打開拉取請求

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE 文件。

🔗 相關項目

• Model Context Protocol - 官方 MCP 規範
• mcp Python SDK - 官方 Python 實現
• mcp TypeScript SDK - 官方 TypeScript 實現

📬 聯繫

• 問題反饋：GitHub Issues
• 討論交流：GitHub Discussions

⭐ 星星曆史

如果您覺得這個項目有幫助，請考慮給它點個星！

為人工智能和 C++ 社區用心打造 ❤️