MCP C++实现

Quick start

Docker-first workflow for all platforms. For details, see BUILD+TEST.MD.

- Linux/macOS:

docker buildx build -f Dockerfile.demo --target test --progress=plain --pull --load -t mcp-cpp-test .
docker buildx build -f Dockerfile.demo --target demo --progress=plain --pull --load -t mcp-cpp-demo .
docker run --rm --name mcp-cpp-demo --mount type=bind,src=$(pwd),dst=/work mcp-cpp-demo

- Windows (PowerShell via WSL2 Ubuntu):

wsl -d Ubuntu -- bash -lc "cd /mnt/c/<path-to-repo>/mcp-cpp && docker buildx build -f Dockerfile.demo --target test --progress=plain --pull --load -t mcp-cpp-test ."
wsl -d Ubuntu -- bash -lc "cd /mnt/c/<path-to-repo>/mcp-cpp && docker buildx build -f Dockerfile.demo --target demo --progress=plain --pull --load -t mcp-cpp-demo ."
wsl -d Ubuntu -- bash -lc "docker run --rm --name mcp-cpp-demo --mount type=bind,src=/mnt/c/<path-to-repo>/mcp-cpp,dst=/work mcp-cpp-demo"

Examples

• examples/typed_quickstart — minimal end-to-end usage of typed wrappers (tools/resources/prompts).
• examples/resource_chunking — demonstrates experimental resource range reads (offset/length) and reassembly of chunks. If the server advertises capabilities.experimental.resourceReadChunking.maxChunkBytes, returned slices are hard-clamped to that size; the example shows how to reassemble correctly using typed helpers.

MCP C++ SDK

A C++20 SDK for the Model Context Protocol (MCP).

Cross-platform (Windows/macOS/Linux), CMake-based. See Docker-first instructions in BUILD+TEST.MD.

API Reference

This section summarizes the primary SDK interfaces and feature-specific APIs.

- Client API header: include/mcp/Client.h - Server API header: include/mcp/Server.h - Transport headers: include/mcp/Transport.h, include/mcp/InMemoryTransport.hpp, include/mcp/StdioTransport.hpp, include/mcp/SharedMemoryTransport.hpp, include/mcp/HTTPTransport.hpp, include/mcp/HTTPServer.hpp

Client API (IClient / Client)

- Connection: Connect(transport), Disconnect(), IsConnected() - Initialize: Initialize(clientInfo, capabilities) → ServerCapabilities - Tools: ListTools(), ListToolsPaged(cursor, limit), CallTool(name, args), CallToolTask(name, args, task) - Tasks: GetTask(taskId), ListTasks(), ListTasksPaged(cursor, limit), GetTaskResult(taskId), CancelTask(taskId) - Resources: ListResources(), ListResourcesPaged(cursor, limit), ReadResource(uri) - Resource templates: ListResourceTemplates(), ListResourceTemplatesPaged(cursor, limit) - Subscriptions: SubscribeResources(), SubscribeResources(optional<string> uri), UnsubscribeResources(), UnsubscribeResources(optional<string> uri) - Prompts: ListPrompts(), ListPromptsPaged(cursor, limit), GetPrompt(name, args) - Utilities: Complete(params), Ping() - Roots and elicitation: SetRootsListHandler(handler), NotifyRootsListChanged(), SetElicitationHandler(handler) - Sampling (server → client): SetSamplingHandler(handler) - Notifications & progress: SetNotificationHandler(method, handler), RemoveNotificationHandler(method), SetProgressHandler(handler), SetErrorHandler(handler)

Example (connect + initialize):

ClientFactory factory; Implementation info{"MyClient","1.0.0"};
auto client = factory.CreateClient(info);
client->Connect(std::move(transport)).get();
ClientCapabilities caps; auto serverCaps = client->Initialize(info, caps).get();

Server API (IServer / Server)

• Lifecycle: Start(transport), Stop(), IsRunning()
• Initialize: HandleInitialize(clientInfo, capabilities)
• Tools: RegisterTool(name, handler) or RegisterTool(tool, handler), UnregisterTool(name), ListTools(), CallTool(name, args), CallToolTask(name, args, task)
• Tasks: GetTask(taskId), ListTasks(), ListTasksPaged(cursor, limit), GetTaskResult(taskId), CancelTask(taskId)
• Resources: RegisterResource(uri, handler) or RegisterResource(resource, handler), UnregisterResource(uri), ListResources(), ReadResource(uri)
• Resource templates: RegisterResourceTemplate(t), UnregisterResourceTemplate(template), ListResourceTemplates()
• Prompts: RegisterPrompt(name, handler) or RegisterPrompt(prompt, handler), UnregisterPrompt(name), ListPrompts(), GetPrompt(name, args)
• Utilities: SetCompletionHandler(handler), RequestCreateMessage(params), RequestCreateMessageTask(params, task), RequestElicitation(request), RequestElicitationTask(request, task), RequestRootsList(), Ping()
• Sampling: SetSamplingHandler(handler)
• Keepalive: SetKeepaliveIntervalMs(intervalMs)
• Logging: LogToClient(level, message, data)
• Notifications: NotifyResourcesListChanged(), NotifyResourceUpdated(uri), NotifyToolsListChanged(), NotifyPromptsListChanged()
• Messaging: SendNotification(method, params), SendProgress(token, progress, message)
• Errors & caps: SetErrorHandler(handler), GetCapabilities(), SetCapabilities(caps)

Transport API (ITransport & factories)

• Core: Start(), Close(), IsConnected(), GetSessionId()
• Messaging: SendRequest(req), SendNotification(note)
• Handlers: SetNotificationHandler(h), SetErrorHandler(h), SetRequestHandler(h)
• Implementations:
• In-memory: include/mcp/InMemoryTransport.hpp
• Stdio: include/mcp/StdioTransport.hpp
• Shared Memory: include/mcp/SharedMemoryTransport.hpp
• HTTP client: include/mcp/HTTPTransport.hpp
• HTTP server/acceptor: include/mcp/HTTPServer.hpp

HTTP Authentication (Bearer/OAuth2)

The HTTP client transport supports static Bearer tokens and OAuth2 client‑credentials. See configuration keys and IAuth injection examples in docs/api/transport.md.