MCP Python SDK — Build MCP Servers & Clients

简介

用 Python 构建 MCP server/client：提供 FastMCP 与 CLI 开发工具，支持 stdio、SSE 与 Streamable HTTP 传输，便于本地调试与集成。

• 适合谁（Best for）: 需要自建 MCP 工具（server）或把 MCP 接入内部 agent 运行时的 Python 团队
• 兼容工具（Works with）: Python、uv/pip 工作流、MCP 传输（stdio/SSE/streamable HTTP）与 FastMCP 装饰器
• 安装时间（Setup time）: 15 分钟

量化信息

• PyPI 安装可选组：mcp[cli]（仓库文档）
• GitHub stars + forks（已核验）：见「来源与感谢」
• 跑通约 15 分钟（Python 环境 + demo server + inspector）

实战要点

最稳的落地路径：先用 FastMCP 写一个只包含 1–2 个工具的 server，用 dev 模式跑起来，再用官方 inspector 验证工具调用链路；跑通后再加鉴权/环境变量管理，并迁移到 HTTP 传输。如果接入 Claude Code，建议显式安装流程，并把工具入参做小且类型化。

安全提示： 不要在 HTTP 传输上暴露无约束的 exec/文件工具；MCP 天生能力强，需要白名单与审计配套。

FAQ

Q: 只能写 server 吗？ A: 不是。SDK 既能写 MCP server，也能写 MCP client 去连接现有 server。

Q: 传输协议怎么选？ A: 本地工具优先 stdio；更接近生产的部署用 Streamable HTTP；SSE 也支持。

Q: 一定要用 uv 吗？ A: 不必须。文档推荐 uv，但 pip 同样可用（pip install "mcp[cli]"）。