FilesLast commitLast update
5 months ago
4 months ago
5 months ago
5 months ago
4 months ago
5 months ago
5 months ago
README

MCP Server Example 说明

功能

server_example.cpp 演示 Streamable HTTP Server,包含:

  • Tool:echo、async_echo、progress_tool、sampling 相关工具等
  • Prompt、Resource、Resource Template
  • Completion
  • 可选鉴权(--auth,端口 8001)
  • 日志写入文件(server_example.log)

前置条件

cd MCP/cpp-sdk
./scripts/build.sh

共享库:output/lib/libmcp.so。头文件:include/mcp/。

运行

cd example/server_example
./run_example.sh

命令行参数

参数 说明
--port=<1-65535> 监听端口,默认 8000;endpoint 为 http://127.0.0.1:<port>/mcp
--stateless 无状态模式(限制部分会话相关 API)
--isJsonResponseDisable 禁用 JSON 响应模式
--auth 启用 Bearer 鉴权,默认 endpoint http://127.0.0.1:8001/mcp
-h, --help 帮助

示例:

./run_example.sh --port=9000
./run_example.sh --auth

或使用统一脚本:

cd MCP/cpp-sdk
./scripts/run_example.sh -t server
./scripts/run_example.sh -p 9000 -t server

与 Client 联调

  1. 保持 Server 运行(默认 http://127.0.0.1:8000/mcp)
  2. 在另一终端运行 Client 示例:
./scripts/run_example.sh -t tool
# 或
cd example/client_example/tool_example && ./run_example.sh

鉴权模式:Server 使用 --auth 后,Client 使用 tool_example 的 --auth 或对应 token。

日志

  • 控制台:部分启动信息(std::cout)
  • SDK 日志:SetLogCallback(FileLogCallback) 写入 server_example/build/server_example.log;级别由 SetLogLevel 统一过滤(见 日志说明)

相关文档