example-mcp-server 是一个面向开发者的本地 MCP(Model Context Protocol)服务示例,主打"零门槛搭一个 Claude 能直接调用的工具"。它把 MCP 服务端搭建、资源注册、工具暴露这一整套流程拆成了可复制的最小样板,方便开发者一边写业务逻辑、一边让 Claude 在本地调试联调。
能接什么
- 本地工具与资源注册:通过装饰器方式把 Python 函数注册成 MCP 工具(tools)和资源(resources),无需手写协议报文。
- stdio / SSE 传输:支持标准输入输出和 Server-Sent Events 两种传输方式,可直接对接 Claude Desktop、Claude Code 等 MCP 客户端。
- 异步任务与结构化输出:原生支持
async函数和 Pydantic 模型返回,复杂参数和富文本结果都能稳定序列化。 - 调试与日志:内置请求/响应日志,方便排查协议握手、参数解析等环节的问题。
是否需要密钥
不需要。本项目运行在本地,默认 无需任何 API Key、Token 或云端凭据,也不发起外网请求。如果你在示例里接入自己的大模型或第三方 API,再按需在自己的代码中配置密钥即可,与 MCP 服务本身无关。