AgentIndex icon
AgentIndex
工具MCP 服务HOT分类热门最新选型清单对比指南
提交工具
工具MCP 服务HOT分类热门最新选型清单对比指南
首页/
API 集成/
python-sdk
python-sdk logo

python-sdk

活跃·★ 24.7k·MIT·更新于 2026-10-27
★ 最受欢迎★ 必备神器

MCP Python SDK 是 Model Context Protocol 的官方 Python 实现,由协议所在的组织直接维护。用它可以编写向任意 MCP 宿主开放工具、资源和提示模板的 MCP Server,也可以编写连接任意 Server 的 MCP Client,并支持所有标准传输方式:stdio、Streamable HTTP 和 SSE。

对于希望与协议规范保持最紧密一致的 Python 开发者,它是参考级的选择,比如开发一个会被许多不同客户端使用的 Server,或者实现自定义的 MCP 宿主。一个最小的 Server 大约 15 行代码;可选的 `cli` 扩展会提供 `mcp` 命令,其中 `mcp dev` 用于在 MCP Inspector 中测试 Server,`mcp run` 用于以指定传输方式运行,`mcp install` 用于把 Server 注册到客户端。v2 版本配有“新特性”说明和完整的 API 参考文档。

上手方式:需要 Python 3.10+。执行 `uv add "mcp[cli]"`(或使用 pip),编写 `server.py`,然后用 `uv run mcp dev server.py` 调试,或用 `uv run mcp run server.py --transport streamable-http` 通过 HTTP 提供服务。

本文根据项目 README 和公开仓库数据整理,我们没有实际试用过该工具。数据截至 2026-10-24。

许可证
MIT
最新发布
v2.3.0 · 2026-10-02
最近提交
2026-10-24
贡献者
196
复刻数
4,073
未关闭的 issue 和 PR
364
首次发布
2024-09-24
PyPI 包
mcp 2.3.0 · 70,116,877 上周下载

来源:GitHub、npm 和 PyPI 的公开接口。

#Python SDK#LLM 集成#模型上下文协议#API 开发#服务器框架#客户端库#AI 工具
$ 安装
$ uv add "mcp[cli]"
↗ 访问官网★ GitHub
01

功能特性

01构建 MCP 服务器,向 LLM 应用程序公开工具、资源和提示。
02开发 MCP 客户端,连接并与任何 MCP 服务器交互。
03支持标准传输协议:stdio、Streamable HTTP 和 SSE。
04通过 Python 类型提示简化服务器开发,无需手动编写 JSON Schema 和验证代码。
02

为什么选择它

+官方 SDK,与协议规范同步最紧密。
+同时覆盖 Server 和 Client,支持所有标准传输方式。
+提供用于开发、运行和安装 Server 的 CLI 工具。
+采用 MIT 许可,有专门的文档站和 API 参考。
03

权衡点

!比高层框架更底层;自动化的客户端工具、交互式应用等功能需要自己多写代码。
!v2 版本修改了 API,升级旧 Server 时请查看迁移说明。
!需要 Python 3.10+;其他语言需要使用对应的官方 SDK。
05

维护状况检查

活跃检查日期: 2026-10-24
最近提交
2026-10-24
近 90 天提交数
100+
近 90 天发布数
10
最新发布
v2.3.0 (2026-10-02)
未关闭 issue
364
近期 issue 至少有一条评论的比例
16/19
近 12 周每周提交数
近 12 周每周提交数: 0, 4, 13, 9, 12, 3, 1, 1, 29, 1, 10, 5

最早的一周在左边,最近 4 周为橙色。数据来源:GitHub 提交统计。

状态规则:GitHub 上已归档 = 已归档;最近提交在 90 天内 = 活跃;91 到 365 天 = 放缓;更久 = 停滞。所有数字来自所示日期的 GitHub API。

讨论最多的未关闭 issue

  • #1705 Document and provide hooks for sandboxing file and network access in MCP tools29 条评论 · 2025-11-28
  • #423 MCP SSE Server: Received request before initialization was complete25 条评论 · 2025-04-03
  • #1401 ClientSession Error Handling24 条评论 · 2025-09-25
  • #262 cannot get response from await session.call_tool()16 条评论 · 2025-03-12
  • #2416 Bug: AssertionError: Request already responded to — cancellation race in v1.27.015 条评论 · 2026-04-09

issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。

04

适合谁

适合选它的情况
  • 你希望使用由 Model Context Protocol 官方组织直接维护的 MIT 许可参考 Python SDK。
  • 需要对 MCP 核心原语(Resources、Prompts、Tools、Sampling)以及标准传输方式(stdio、SSE、Streamable HTTP)进行完整的底层控制。
建议换别的情况
  • 希望获得更高层的开发便利性(如客户端自动组合、更少的样板代码);FastMCP 提供了更丰富的高层封装。
  • 只是想把现有的 GraphQL 或 FastAPI 服务暴露为 MCP,使用 Grafbase 或 FastAPI-MCP 无需手写工具函数。
06

与同类的区别

fastmcp logovs fastmcp★ 28.2k

官方 Python SDK(MIT)是 MCP 组织维护的标准协议实现;FastMCP(Apache-2.0)则面向服务端、客户端与交互式应用提供了更高层的开发框架。

完整横向对比 →
07

兼容性

Python
运行时
已通过文档验证
08

快速开始

1
$ uv add "mcp[cli]"
09

使用场景

↳将自定义业务逻辑和数据源与基于 LLM 的应用程序集成。
↳为 LLM 创建安全、标准化的接口以访问外部功能。
↳开发 AI 系统的模块化和可互操作组件。
↳构建可供各种 LLM 主机使用的后端服务。
10

同类工具

⚡热门对决:
VSfastmcp★28.2k→VSruby-sdk★940→VSfastmcp-ts★80→VSmcp-server-cloudflare★4.4k→
fastmcp logo
fastmcp★ 28.2k
FastMCP 是一个用于连接大型语言模型 (LLM) 到工具和数据的 Python 框架,旨在简化从原型到生产的 MCP (Model Context Protocol) 应用开发。
VS对比→
ruby-sdk logo
ruby-sdk★ 940
Model Context Protocol 服务器和客户端的官方 Ruby SDK。
VS对比→
fastmcp-ts logo
fastmcp-ts★ 80
一个用于构建模型上下文协议(MCP)服务器、客户端和应用程序的TypeScript框架。
VS对比→
mcp-server-cloudflare logo
mcp-server-cloudflare★ 4.4k
Cloudflare MCP Server 提供了多个模型上下文协议(MCP)服务器,允许MCP客户端通过自然语言与Cloudflare服务交互并执行任务。
VS对比→
ext-apps logo
ext-apps★ 3.0k
为MCP工具构建交互式UI,如图表、表单、仪表盘,可在Claude、ChatGPT及其他兼容聊天客户端中内联渲染。
VS对比→
Figma-Context-MCP logo
Figma-Context-MCP★ 16.1k
一个用于Figma的模型上下文协议(MCP)服务器,让AI编码代理能够访问Figma设计数据,实现任何框架的设计一键生成。
VS对比→
mcp-server-arangodb logo
mcp-server-arangodb★ 46
一个用于ArangoDB的模型上下文协议(MCP)服务器,通过TypeScript实现,使AI代理能够与ArangoDB数据库进行交互。
VS对比→
gopher-mcp logo
gopher-mcp★ 16
一个现代、跨平台的模型上下文协议(MCP)服务器,使AI助手能够安全高效地浏览和与Gopher协议及Gemini协议资源交互。
VS对比→
查看全部替代品 →

收录于以下清单

  • 构建与暴露 MCP 服务器的 SDK、开发框架与官方参考实现

评论

登录后发表评论

暂无评论,来发表第一条吧

本页内容
01功能特性02为什么选择它03权衡点05维护状况检查04适合谁06与同类的区别07兼容性08快速开始09使用场景10同类工具
modelcontextprotocol /
python-sdk
↗

MCP Server 和 Client 的官方 Python SDK

24.7k4.1kMIT
最后更新1天前
状态活跃
分类API 集成
贡献者196
最新发布v2.3.0
链接
文档↗讨论↗问题↗版本↗
推荐云部署
Ad

在 DigitalOcean 上一键部署

为你的 MCP 服务、Docker 容器与智能体提供即开即用云服务器,新用户立享 $200 免费额度(60天有效)。

立即领取 $200 免费额度
© 2026 AgentIndex.app|由十年 iOS 开发者构建。
按场景挑选关于我们联系我们广告合作隐私政策使用条款QYSGitHub请作者喝咖啡 ☕

按分类浏览

MCP 服务器代码助手工作流自动化RAG / 知识库多智能体浏览器自动化大模型基础设施开发者工具可观测性

与 Anthropic, OpenAI 或 Microsoft 无关。