MCP Client Example 说明
目录结构
client_example/
├── tool_example/ # 初始化、Ping、Tool、Progress、Complete
├── prompt_example/ # Prompt
├── resource_example/ # Resource 订阅与读取
├── sampling_example/ # 服务端发起的 Sampling
└── run_all_examples.sh # 依次运行 tool / prompt / resource(不含 sampling)
示例内容
| 示例 | 主要 API |
|---|---|
tool_example |
Initialize、SendPing、ListTools、CallTool、Complete |
prompt_example |
ListPrompts、GetPrompt |
resource_example |
ListResources、ReadResource、SubscribeResource |
sampling_example |
SetSamplingCreateMessageCallback、CallTool(触发服务端 sampling) |
前置条件
- 已编译 SDK:
cd MCP/cpp-sdk
./scripts/build.sh
产物路径:../../output/lib/libmcp.so(相对于各示例子目录)。头文件使用源码树 ../../include/mcp/。
- MCP Server 已启动,默认端点:
http://127.0.0.1:8000/mcp
双终端(推荐调试 Client 时)
# 终端 1(MCP/cpp-sdk 目录)
sh scripts/run_example.sh -t server # 前台常驻,Ctrl+C 停止
# 终端 2
sh scripts/run_example.sh -t tool
单终端一键
sh scripts/run_example.sh -t all
运行单个示例
cd tool_example && ./run_example.sh
cd prompt_example && ./run_example.sh
cd resource_example && ./run_example.sh
cd sampling_example && ./run_example.sh
指定端口(需与 Server 一致):
./run_example.sh --port=9000
tool_example 鉴权模式(Server 需以 --auth 启动,默认连 http://127.0.0.1:8001/mcp):
cd tool_example && ./run_example.sh --auth
运行多个示例(不含 sampling)
./run_all_examples.sh