MCP Python SDK：给大模型接入工具和数据的标准协议

MCP Python SDK：给大模型接入工具和数据的标准协议

MCP Python SDK 是 Model Context Protocol 的 Python 实现，目前在 GitHub 上获得了 23,000 多个 Star。

Model Context Protocol（MCP）是一个开放协议，让应用程序能够以标准化的方式向大语言模型提供上下文信息。简单来说，它定义了一套规则，告诉大模型"你能用哪些工具、能看哪些数据"。

MCP Python SDK 让开发者可以用 Python 快速搭建 MCP 服务端，也可以构建客户端去连接已有的 MCP 服务。

这个 SDK 的核心概念有三个：Resources、Tools 和 Prompts。

Resources 负责向大模型暴露数据，类似 REST API 中的 GET 接口。Tools 负责执行操作，类似 POST 接口，可以调用函数、写数据库、发请求。Prompts 则是可复用的交互模板，定义大模型和用户之间的对话模式。

SDK 提供了 FastMCP 这个高层接口，用装饰器就能定义工具和资源，代码量很少：

frommcp.server.fastmcpimportFastMCP mcp=FastMCP("Demo")@mcp.tool()defadd(a:int,b:int)->int:"""Add two numbers"""returna+b@mcp.resource("greeting://{name}")defget_greeting(name:str)->str:returnf"Hello,{name}!"

传输方式上，SDK 支持 stdio、SSE 和 Streamable HTTP 三种。stdio 适合本地进程间通信，SSE 和 HTTP 适合远程服务。Streamable HTTP 是较新的方案，支持流式传输，也能挂载到已有的 ASGI 服务器上。

安装方式很简单，推荐用 uv 管理项目依赖：

uvadd"mcp[cli]"

也可以直接用 pip：

pipinstall"mcp[cli]"

SDK 可以和 Claude Desktop、Claude Code 集成。写好 MCP 服务端后，一条命令就能把它注册到 Claude Code 里：

claude mcpadd--transporthttp my-server http://localhost:8000/mcp

注册完成后，大模型就能直接调用你定义的工具和资源了。

除了服务端，SDK 也支持构建 MCP 客户端。客户端可以连接任意 MCP 服务端，解析返回的工具列表和资源内容。SDK 还提供了 OAuth 认证支持，方便对接需要鉴权的服务。

目前 MCP Python SDK 的 v1.x 是稳定版本，v2 已进入 alpha 阶段，预计 2026 年 7 月底发布正式版。v2 在传输层和 API 设计上做了不少调整，如果你的项目依赖这个 SDK，建议在版本约束中加上<2上限。

MCP 协议本身由 Anthropic 主导，目标是成为大模型工具调用领域的通用标准。目前已经有相当数量的服务端实现和客户端支持，生态在持续扩展。

hropic 主导，目标是成为大模型工具调用领域的通用标准。目前已经有相当数量的服务端实现和客户端支持，生态在持续扩展。