MCP Python SDK

它做什么

• MCP 官方 Python SDK，modelcontextprotocol 组织维护，覆盖客户端与服务端
• 装饰器风格的 MCPServer API 定义 tool/resource/prompt，另有底层类做完整协议控制
• asyncio 优先，同步/异步双栈；stdio 与 Streamable HTTP 开箱即用
• 现已发布 2.x——v1.x 转入维护分支，继续收安全修复

什么时候用

在官方实现上写 Python MCP server 的正路（FastMCP 框架是同协议上的易用层）。也是给 Python agent 嵌入 MCP 能力的客户端 SDK——需要完整 agent 循环时配 claude-agent-sdk-python。

如何上手

pip install "mcp[cli]"
# 或
uv add "mcp[cli]"

最小 server（2.x）：

from mcp.server import MCPServer

mcp = MCPServer("Demo")

@mcp.tool()
def add(a: int, b: int) -> int:
    return a + b

注意事项

2.x 相对 1.x 改了 API（FastMCP 导入变成 MCPServer）——迁移前 pin 住 mcp<2；v1.x 分支继续收安全补丁。stdio 零配置即可用；HTTP 传输与开发调试器需要 [cli] extra。