modelcontextprotocol/python-sdk

这是什么？

核心功能

• 01通过带类型注解的 Python 函数构建 MCP 服务端，提供工具、资源和提示词。
• 02构建 MCP 客户端，可连接本地 stdio 服务端或远程 Streamable HTTP 服务端。
• 03支持 stdio、Streamable HTTP 和 SSE 传输方式。
• 04提供 `mcp` 命令行工具，用于运行服务端和启动 MCP Inspector。

适用场景

• 将内部 API 或数据库以 MCP 工具的形式提供给 LLM 助手。
• 编写 Python 客户端，调用已有 MCP 服务端的工具。
• 借助 MCP Inspector 快速原型开发和调试 MCP 服务端。

快速上手

1. 1

   使用 uv 安装带 CLI 扩展的 SDK

   uv add "mcp[cli]"
2. 2

   或使用 pip 安装

   pip install "mcp[cli]"
3. 3

   按照 README 示例创建包含工具和资源的 server.py

4. 4

   在 MCP Inspector 中运行服务器

   uv run mcp dev server.py

使用前须知

• !需要 Python 3.11 或更高版本。
• !README 中的文档针对 v2 API，较旧的教程和示例可能与之不符。

标签

常见问题

python-sdk 是什么？

官方 Python SDK，用于构建 Model Context Protocol 服务端和客户端，连接 LLM 应用与工具、数据和提示词。 MCP Python SDK 是 Model Context Protocol 的官方 Python 实现。该协议是一种开放标准，用于以安全、统一的方式向 LLM 应用暴露数据和功能。开发者可以用它编写 MCP 服务端，向任意 MCP 宿主提供工具、资源和提示词，也可以编写 MCP 客户端连接任意 MCP 服务端。

python-sdk 可以免费使用吗？用的什么许可证？

python-sdk 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

python-sdk 还在维护吗？

活跃维护中。python-sdk 最近一次提交是在 2026年10月17日。

python-sdk 适合用来做什么？

将内部 API 或数据库以 MCP 工具的形式提供给 LLM 助手。 编写 Python 客户端，调用已有 MCP 服务端的工具。 借助 MCP Inspector 快速原型开发和调试 MCP 服务端。

python-sdk 怎么安装和运行？

使用 uv 安装带 CLI 扩展的 SDK: uv add "mcp[cli]" 或使用 pip 安装: pip install "mcp[cli]" 按照 README 示例创建包含工具和资源的 server.py 在 MCP Inspector 中运行服务器: uv run mcp dev server.py

在哪里获取 python-sdk？

源代码和安装说明在 GitHub 上：https://github.com/modelcontextprotocol/python-sdk