用途:在 Python 中按官方 MCP Python SDK v2 生成 MCP 服务器,SDK v2 支持 MCP 规范 2026-07-28 修订版,同时服务使用更早修订版的客户端。工作流分五步:创建项目、编写服务器、编写测试、运行测试直至通过、配置客户端。
主要能力:通过装饰器把函数暴露为工具(@mcp.tool()),把 URI 暴露为资源(@mcp.resource),并支持提示(@mcp.prompt())。输入模式由类型标注生成,工具描述来自 docstring;返回 Pydantic 模型或 TypedDict 时,输出模式由返回类型生成。可用 ToolAnnotations 标注只读或破坏性工具。
用法:uv init --app --no-package project-name;uv add "mcp[cli]>=2,<3";uv add --dev pytest。服务器写在 server.py,默认使用 stdio 传输。测试用内存 Client(mcp),运行 uv run pytest。客户端配置示例包含 VS Code 的 .vscode/mcp.json 与 Claude Desktop 的 uv run mcp install server.py。启动用 uv run server.py,调试用 uv run mcp dev server.py(需 Node.js)。
限制:SDK v2 移除了 FastMCP 与 mcp.server.fastmcp;不要照搬 SDK v1 示例。传输选项应传给 run() 而非 MCPServer(...)。stdio 下 stdout 是协议通道,不能 print(),日志写 stderr。工具失败应抛 ToolError,不要抛 MCPError。不要使用 ctx.elicit(),用户输入用 Resolve(fn)。2026-07-28 修订版弃用采样、协议日志与 Roots,且无 SSE 传输,远程服务器用 Streamable HTTP。