GopherSecurity/gopher-mcp

# MCP C++ SDK - C++ 的模型上下文协议实现 [](https://isocpp.org/) [](https://modelcontextprotocol.io/) [](LICENSE) []() []() **The most comprehensive C++ implementation of the Model Context Protocol (MCP)** for building AI-powered applications. Production-ready SDK with enterprise features including multi-transport support, connection pooling, and **multi-language bindings via C API (Python, TypeScript, Go, Rust, Java, C#, Ruby and more)**. ## Table of Contents - [Architecture](#architecture) - [Cross-Language Support](#cross-language-support) - [What is MCP?](#what-is-mcp) - [Features](#features) - [Quick Start](#quick-start) - [Examples](#examples) - [Installation](#installation) - [Documentation](#documentation) - [FAQ](#faq) - [Contributing](#contributing) - [License](#license) ## 架构 ``` ┌─────────────────────────────────────────────────────────────┐ │ Application Layer │ │ MCP Server / Client / Custom Applications │ ├─────────────────────────────────────────────────────────────┤ │ Cross-Language Binding Layer │ │ Python │ TypeScript │ Go │ Rust │ Java │ C# │ Ruby │ ├─────────────────────────────────────────────────────────────┤ │ C API (FFI Layer) │ │ libgopher_mcp_c: Opaque Handles │ Memory Safety │ │ RAII Guards │ Type Safety │ Error Handling │ ├─────────────────────────────────────────────────────────────┤ │ Protocol Layer │ │ MCP JSON-RPC Protocol Implementation │ │ Request/Response/Notification Handling │ ├─────────────────────────────────────────────────────────────┤ │ Filter Chain Layer │ │ HTTP Codec │ SSE Codec │ Routing │ Rate Limiting │ │ Circuit Breaker │ Metrics │ Backpressure │ Auth │ ├─────────────────────────────────────────────────────────────┤ │ Transport Layer │ │ Stdio │ HTTP(s)+SSE │ WebSocket │ TCP │ Redis │ P2P │ ├─────────────────────────────────────────────────────────────┤ │ Network Layer │ │ Connection Management │ Listener │ Socket Interface │ ├─────────────────────────────────────────────────────────────┤ │ Event Loop & Dispatcher │ │ Libevent Integration │ Timer Management │ I/O Events │ └─────────────────────────────────────────────────────────────┘ ``` ### 设计原则 1. **Thread-Safe Dispatcher Model** - All I/O in dispatcher threads, no complex synchronization 2. **Filter Chain Architecture** - Modular, composable request processing 3. **Production Patterns** - Connection pooling, circuit breaker, graceful shutdown ## 跨语言支持 **Use MCP C++ SDK from any programming language** via the stable C API (`libgopher_mcp_c`): | Language | Binding Type | Features | |----------|--------------|----------| | **Python** | ctypes/cffi | Async support, type hints | | **TypeScript/Node.js** | N-API | High performance, native async | | **Go** | CGO | Goroutine-safe wrappers | | **Rust** | FFI | Safe wrappers, ownership guarantees | | **Java** | JNI | Automatic resource management | | **C#/.NET** | P/Invoke | Async/await support | | **Ruby** | Native extension | GC integration | ``` # 安装路径 Headers: /usr/local/include/gopher-mcp/mcp/c_api/ Library: /usr/local/lib/libgopher_mcp_c.{so,dylib,dll} ``` ## 什么是 MCP？ **Model Context Protocol (MCP)** is an open protocol that enables AI models (like Claude, GPT, etc.) to securely interact with external tools, data sources, and services. MCP provides a standardized way for: - **AI assistants** to access files, databases, and APIs - **Developers** to expose tools and resources to AI models - **Applications** to integrate AI capabilities with enterprise systems This MCP C++ SDK implements the [official MCP specification](https://modelcontextprotocol.io/) in high-performance C++, suitable for: - Embedded systems and IoT devices - High-frequency trading and real-time applications - Game engines and graphics applications - Native desktop and mobile applications - Backend services requiring low latency ## 特性 | Category | Features | |----------|----------| | **Protocol** | Full MCP 2025-06-18 specification, JSON-RPC 2.0, resources, tools, prompts | | **Transports** | stdio, HTTP+SSE, HTTPS+SSE, WebSocket, TCP | | **Performance** | Zero-copy buffers, lock-free operations, connection pooling | | **Reliability** | Circuit breaker, rate limiting, retry with backoff, graceful shutdown | | **Security** | TLS/SSL, authentication middleware, request validation | | **Observability** | Structured logging, metrics, health endpoints | | **Cross-Language** | C API for Python, Node.js, Go, Rust, Java, C#, Ruby bindings | ## 快速开始 ### 构建与安装 ``` # 显示所有可用命令 make help # 构建 make # 安装（如果需要则自动提示输入 sudo） make install # 运行测试 make test ``` ### 创建 MCP 服务器 ``` #include "mcp/server/mcp_server.h" int main() { mcp::server::McpServerConfig config; config.server_name = "my-mcp-server"; auto server = mcp::server::createMcpServer(config); // Register a tool mcp::Tool calculator; calculator.name = "add"; calculator.description = "Add two numbers"; server->registerTool(calculator, [](const std::string& name, const mcp::optional& arguments, mcp::server::SessionContext& ctx) { mcp::CallToolResult result; auto args = arguments.value(); auto a_it = args.find("a"); auto b_it = args.find("b"); double a = mcp::holds_alternative(a_it->second) ? mcp::get(a_it->second) : 0.0; double b = mcp::holds_alternative(b_it->second) ? mcp::get(b_it->second) : 0.0; result.content.push_back(mcp::TextContent{"Result: " + std::to_string(a + b)}); return result; }); server->listen("http://0.0.0.0:3000"); server->run(); } ``` ### 创建 MCP 客户端 ``` #include "mcp/client/mcp_client.h" int main() { mcp::client::McpClientConfig config; config.client_name = "my-mcp-client"; auto client = mcp::client::createMcpClient(config); client->connect("http://localhost:3000"); // Initialize protocol auto init = client->initializeProtocol().get(); // Call a tool auto args = mcp::make() .add("a", 10.0) .add("b", 5.0) .build(); auto result = client->callTool("add", mcp::make_optional(args)).get(); } ``` ## 示例 See [examples/mcp/README.md](examples/mcp/README.md) for complete working examples: ``` # 终端 1：启动服务器 ./build/examples/mcp/mcp_example_server --verbose # 终端 2：使用演示运行客户端 ./build/examples/mcp/mcp_example_client --demo --verbose ``` The example server includes: - Resource registration and subscriptions - Tool execution (calculator, database query, system info) - Prompt templates - Session management - HTTP/SSE endpoints ## 安装 ### 先决条件 - C++14 compiler (GCC 8+, Clang 10+, MSVC 2019+) - CMake 3.10+ - libevent 2.1+ - OpenSSL 1.1+ (optional, for TLS) ### 构建选项 ``` # 调试构建 make debug # 发布构建 make release # 仅静态库 cmake -B build -DBUILD_SHARED_LIBS=OFF # 无 C API cmake -B build -DBUILD_C_API=OFF # 自定义安装前缀 cmake -B build -DCMAKE_INSTALL_PREFIX=~/.local ``` ### Windows（通过 Cygwin + MinGW） Building on Windows requires Cygwin with MinGW-w64 toolchain: #### 先决条件 Install [Cygwin](https://www.cygwin.com/) with these packages: - `make`, `cmake` - Build tools - `mingw64-x86_64-gcc-g++` - MinGW C++ compiler - `mingw64-x86_64-libevent` - Event library - `mingw64-x86_64-openssl` - SSL/TLS library #### 构建命令 ``` # 从 Cygwin bash shell 运行 ./build-mingw.sh # Release build (default) ./build-mingw.sh debug # Debug build ./build-mingw.sh release # Release build ./build-mingw.sh clean # Clean build directory ``` #### 输出 - Build directory: `build-mingw/` - Executable: `build-mingw/examples/mcp/mcp_example_server.exe` ## 文档 ### MCP C++ 文档 - [Examples Guide](examples/mcp/README.md) - Working server and client examples ### MCP CPP 核心组件 - [MCP Protocol in C++](docs/mcp_protocol.md) - Model Context Protocol implementation details - [Filter Chain](docs/filter_chain.md) - Processing pipeline architecture - [Transport Layer](docs/transport_layer.md) - Transport implementations - [Network Layer](docs/network_layer.md) - Connection management and socket abstraction ### 设计文档 - [Event Loop Design](docs/event_loop_design.md) - Event-driven architecture and dispatcher design - [Filter Usage Guide](docs/filter_usage_guide.md) - Comprehensive guide for using and creating filters - [CTAD Alternatives](docs/CTAD_alternatives.md) - Class Template Argument Deduction alternatives for C++14 - [MCP Serialization Coverage](docs/MCP_serialization_coverage.md) - JSON serialization implementation details ## 常见问题解答 ### 什么是模型上下文协议？ MCP is an open protocol by Anthropic that standardizes how AI models interact with external tools and data. It defines JSON-RPC methods for resources (data), tools (actions), and prompts (templates). ### 为什么在 MCP 中使用 C++？ C++ provides maximum performance and portability. This SDK is ideal for embedded systems, real-time applications, game engines, and any environment where Python/Node.js overhead is unacceptable. ### 它是否适用于 Claude、GPT 和其他 AI 模型？ Yes. MCP is model-agnostic. Any AI system that supports MCP can use servers built with this SDK. ### 如何将其集成到我的 Python/Node.js 应用程序中？ Use the C API bindings. The SDK provides a stable C interface that can be called from any language with FFI support. ### 这是否适用于生产环境？ Yes. The SDK includes connection pooling, circuit breakers, rate limiting, TLS support, and comprehensive error handling suitable for enterprise deployments. ### 支持哪些传输方式？ - **stdio** - Standard input/output (CLI tools) - **HTTP+SSE** - HTTP with Server-Sent Events (web applications) - **HTTPS+SSE** - Secure HTTP+SSE - **WebSocket** - Bidirectional real-time - **TCP** - Raw TCP sockets ## 关键词与搜索词 `MCP C++`, `MCP CPP`, `Model Context Protocol C++`, `MCP SDK`, `C++ MCP`, `CPP MCP`, `Model Context Protocol CPP`, `MCP implementation`, `AI model integration C++`, `LLM integration C++`, `MCP server C++`, `MCP client C++`, `Model Context Protocol SDK`, `C++ AI SDK`, `Enterprise MCP`, `Production MCP C++` ## 许可证 Apache License 2.0 - see [LICENSE](LICENSE) for details. ## 相关项目 - [Model Context Protocol Specification](https://modelcontextprotocol.io/) - [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk) - [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk)

标签：AI 应用, Apache 2.0, Bash脚本, C API, C++ SDK, Go, LLM 集成, MCP, Model Context Protocol, Mutation, Python, Ruby, Ruby工具, Rust, TypeScript, 企业级安全, 可视化, 多传输支持, 多语言支持, 安全插件, 安全测试工具, 安全测试框架, 客户端, 开源, 无后门, 服务端, 生产级, 知识库, 网络流量审计, 跨语言绑定, 连接性, 连接池