Cpp MCP SDK

mcpc++SDK

   

首个完全符合MCP 2025-11-25标准的C++SDK -构建生产就绪的MCP服务器和客户端，提供完整的协议支持，包括可流式HTTP传输和基于OAuth的授权。

特性

完成MCP 2025-11-25的实施

• 运输：stdio+流式HTTP（单端点，可恢复SSE）
• 服务器功能：工具、资源、带有完整CRUD操作的提示
• 客户特点：根、采样、启发式（表单+URL模式）
• 公用事业：Ping、取消、进度、任务、分页、日志记录、完成
• 授权：OAuth 2.1+PKC、RFC9728发现、WWW身份验证挑战
• 安全：源验证、SSRF保护、运行时间限制、令牌存储抽象

与跨平台支持

• Linux （Ubuntu 24.04+）
• macOS (14+)
• 视窗 （服务器2022+）

生产就绪

• 综合测试套件（18K+行，一致性+集成测试）
• 具有可复制构建的固定依赖关系的CI/CD
• 广泛的文档和安全指南
• 零原始指针-RAII贯穿始终

快速开始

先决条件

• CMake 3.16+
• C++17编译器（GCC 7+、Clang 5+、MSVC 2017+）
• vcpkg（用于依赖关系管理）
• Python 3.12+（用于代码库检查）

构建

# Clone the repository
git clone https://github.com/itcv-GmbH/cpp-mcp-sdk.git
cd cpp-mcp-sdk

# Configure (macOS/Linux)
cmake --preset vcpkg-unix-release

# Configure (Windows)
cmake --preset vcpkg-windows-release

# Build
cmake --build build/vcpkg-unix-release        # macOS/Linux
cmake --build build/vcpkg-windows-release --config Release --parallel  # Windows

测试

# Run all tests
ctest --test-dir build/vcpkg-unix-release

# Run specific test
ctest --test-dir build/vcpkg-unix-release -R mcp_sdk_smoke_test -V

基本示例-MCP服务器

#include 
#include 
#include 

auto main() -> int
{
  try
  {
    // Create server with stdio transport
    auto server = mcp::Server::create();
    
    // Register a tool
    server->registerTool(
      mcp::server::ToolDefinition{
        .name = "echo",
        .description = "Echo back the input message",
        .inputSchema = R"({
          "type": "object",
          "properties": {
            "message": {"type": "string"}
          },
          "required": ["message"]
        })"_json
      },
      [](const mcp::server::ToolCallContext& ctx) -> mcp::server::CallToolResult {
        auto message = ctx.arguments["message"].asString();
        return mcp::server::CallToolResult::success(
          mcp::server::ResourceContent::text("echo://result", message)
        );
      }
    );
    
    // Start server (blocks on stdio)
    server->start();
    
    return 0;
  }
  catch (const std::exception& e)
  {
    std::cerr 
#include 
#include 

auto main() -> int
{
  try
  {
    // Create client
    auto client = mcp::Client::create();
    
    // Connect to MCP server via HTTP
    client->connectHttp(mcp::transport::http::HttpClientOptions{
      .serverUrl = "http://localhost:8080/mcp"
    });
    
    // Initialize session
    auto initResponse = client->initialize().get();
    
    // List available tools
    auto toolsResult = client->listTools();
    std::cout callTool("echo", {{"message", "Hello, MCP!"}});
    
    return 0;
  }
  catch (const std::exception& e)
  {
    std::cerr << "Client error: " << e.what() << '\n';
    return 1;
  }
}

安装

使用vcpkg（覆盖端口）

# In your CMakeLists.txt
find_package(mcp_sdk CONFIG REQUIRED)
target_link_libraries(your_target PRIVATE mcp::sdk)

使用CMake获取内容

include(FetchContent)

FetchContent_Declare(
  mcp_sdk
  GIT_REPOSITORY https://github.com/itcv-GmbH/cpp-mcp-sdk.git
  GIT_TAG        v0.1.0  # or specific commit
)

FetchContent_MakeAvailable(mcp_sdk)
target_link_libraries(your_target PRIVATE mcp::sdk)

文档

• API概述 -高层架构
• 服务器快速启动 -构建MCP服务器
• 客户快速入门 -构建MCP客户端
• 安全指南 -安全最佳实践
• 依赖项 -依赖关系管理
• 版本策略 -协议版本控制策略

例子

看 examples/ 完整工作示例目录：

• minimal_example.cpp -SDK基本用法
• stdio_server/ -stdio传输服务器
• dual_transport_server/ -多传输服务器（stdio+HTTP）
• http_listen_example/ -具有侦听模式的HTTP服务器
• bidirectional_sampling_elicitation/ -客户抽样和启发
• http_server_auth/ -带有OAuth的HTTP服务器（需要TLS）
• http_client_auth/ -具有身份验证的HTTP客户端（需要TLS）
• consumer_find_package/ -CMake消费者示例
• consumer_vcpkg_overlay/ -vcpkg覆盖消费者示例

建筑

include/mcp/
├── server/          # Server component (tools, resources, prompts)
├── client/          # Client component (roots, sampling, elicitation)
├── transport/       # Transports (stdio, Streamable HTTP)
├── jsonrpc/         # JSON-RPC 2.0 layer
├── auth/            # OAuth authorization
├── security/        # Security policies and limits
├── schema/          # JSON Schema validation
├── lifecycle/       # Session lifecycle management
└── util/            # Utilities (tasks, cancellation, progress)

测试

测试类别

• 单元测试：单个组件测试
• 一致性测试：MCP规范合规性验证
• 集成测试：跨SDK互操作性
• 特征矩阵测试：构建配置变体

运行测试

# All tests
ctest --test-dir build/vcpkg-unix-release

# Conformance tests only
ctest --test-dir build/vcpkg-unix-release -L conformance

# Integration tests (requires MCP_SDK_INTEGRATION_TESTS=ON)
ctest --test-dir build/vcpkg-unix-release -L integration

编译选项

合规

这个SDK是 完全符合 根据MCP规范2025-11-25：

• ✅ 可流式HTTP传输（单端点，可恢复SSE）
• ✅ OAuth 2.1+PKCE授权
• ✅ RFC9728资源元数据发现
• ✅ 所有服务器功能（工具、资源、提示）
• ✅ 所有客户端特征（根、采样、启发）
• ✅ 所有实用程序（ping、取消、进度、任务）
• ✅ 跨平台（Linux、macOS、Windows）

请参阅中的MCP规范 .docs/requirements/mcp-spec-2025-11-25/ 了解详细的协议要求。

依赖项

通过vcpkg管理：

• jsons -JSON处理
• 促进。亚西奥 -异步I/O
• 促进。野兽 -HTTP/WebSocket
• 促进。过程 -流程管理
• OpenSSL -TLS/加密（可选）
• Catch2 -测试框架

贡献

1. 阅读 代理商.md 发展指南
2. 创建要素分支
3. 按照代码风格（clang-format/clang-tidy）进行更改
4. 运行测试： ctest --test-dir build/vcpkg-unix-release
5. 运行代码库检查： cmake --build build/vcpkg-unix-release --target codebase-check
6. 提交拉取请求

代码质量

# Format code
cmake --build build/vcpkg-unix-release --target clang-format

# Check formatting
cmake --build build/vcpkg-unix-release --target clang-format-check

# Run all codebase checks
python3 tools/checks/run_checks.py

许可证

分布在 MIT许可证。参见 许可证 了解详情。

致谢

• 模型上下文协议 规范团队
• vcpkg 用于依赖关系管理
• Catch2 用于测试框架