MCP Protocol Framework

Core Features

How to Build

cmake -B build
cmake --build build --config Release

git submodule update --init --recursive # Get GoogleTest
cmake -B build -DMCP_BUILD_TESTS=ON
cmake --build build --config Release

git submodule update --init --recursive # Get GoogleTest
cmake -B build -DMCP_SSL=ON
cmake --build build --config Release

Adopters

Components

Core Components

Client Interface (mcp_client.h)

SSE Client (mcp_sse_client.h, mcp_sse_client.cpp)

Stdio Client (mcp_stdio_client.h, mcp_stdio_client.cpp)

Message Processing (mcp_message.h, mcp_message.cpp)

Tool Management (mcp_tool.h, mcp_tool.cpp)

Resource Management (mcp_resource.h, mcp_resource.cpp)

Server (mcp_server.h, mcp_server.cpp)

Examples

HTTP Server Example (examples/server_example.cpp)

HTTP Client Example (examples/client_example.cpp)

Stdio Client Example (examples/stdio_client_example.cpp)

Agent Example (examples/agent_example.cpp)

./build/examples/agent_example --base-url <base_url> --endpoint <endpoint> --api-key <api_key> --model <model_name>

How to Use

Setting up an HTTP Server

// Create and configure the server
mcp::server server("localhost", 8080); // Host and port
server.set_server_info("MCP Example Server", "0.1.0"); // Name and version
// Register tools
mcp::json hello_handler(const mcp::json& params, const std::string /* session_id */) {
 std::string name = params.contains("name") ? params["name"].get<std::string>() : "World";
 // Server will catch exceptions and return error contents
 // For example, you can use `throw mcp::mcp_exception(mcp::error_code::invalid_params, "Invalid name");` to report an error
 // Content should be a JSON array, see: https://modelcontextprotocol.io/specification/2024-11-05/server/tools#tool-result
 return {
 {
 {"type", "text"},
 {"text", "Hello, " + name + "!"}
 }
 };
}
mcp::tool hello_tool = mcp::tool_builder("hello")
 .with_description("Say hello")
 .with_string_param("name", "Name to say hello to", "World")
 .build();
server.register_tool(hello_tool, hello_handler);
// Register resources
auto file_resource = std::make_shared<mcp::file_resource>("<file_path>");
server.register_resource("file://<file_path>", file_resource);
// Start the server
server.start(true); // Blocking mode

Creating an HTTP Client

// Connect to the server
mcp::sse_client client("localhost", 8080);
// Initialize the connection
client.initialize("My Client", "1.0.0");
// Call a tool
mcp::json params = {
 {"name", "Client"}
};
mcp::json result = client.call_tool("hello", params);

Using the SSE Client

#include "mcp_sse_client.h"
// Create a client, specifying the server address and port
mcp::sse_client client("localhost", 8080);
// Or use a base URL
// mcp::sse_client client("http://localhost:8080");
// Set an authentication token (if needed)
client.set_auth_token("your_auth_token");
// Set custom request headers (if needed)
client.set_header("X-Custom-Header", "value");
// Initialize the client
if (!client.initialize("My Client", "1.0.0")) {
 // Handle initialization failure
}
// Call a tool
json result = client.call_tool("tool_name", {
 {"param1", "value1"},
 {"param2", 42}
});

Using the Stdio Client

#include "mcp_stdio_client.h"
// Create a client, specifying the server command
mcp::stdio_client client("npx -y @modelcontextprotocol/server-everything");
// mcp::stdio_client client("npx -y @modelcontextprotocol/server-filesystem /path/to/directory");
// Initialize the client
if (!client.initialize("My Client", "1.0.0")) {
 // Handle initialization failure
}
// Access resources
json resources = client.list_resources();
json content = client.read_resource("resource://uri");
// Call a tool
json result = client.call_tool("tool_name", {
 {"param1", "value1"},
 {"param2", "value2"}
});

License