如何快速上手 Model Context Protocol Python SDK：构建 LLM 交互应用的完整指南

【免费下载链接】python-sdk The official Python SDK for Model Context Protocol servers and clients 项目地址: https://gitcode.com/gh_mirrors/pythonsd/python-sdk

Model Context Protocol (MCP) Python SDK 是 GitHub 加速计划下 pythonsd 项目的核心组件，它提供了标准化接口，帮助开发者轻松构建与大型语言模型（LLM）交互的服务器和客户端应用。通过分离上下文提供与 LLM 交互的关注点，该 SDK 让 AI 应用开发变得简单高效 🚀

为什么选择 MCP Python SDK？

MCP Python SDK 采用现代化技术栈，确保开发体验流畅高效：

• Python 原生支持：全量使用 Python 开发，兼容 Python 3.7+ 环境
• FastAPI 驱动：基于 FastAPI 构建高性能 ASGI 服务器，支持异步操作
• 标准化协议：遵循 Model Context Protocol 规范，确保不同应用间的互操作性
• 丰富示例：提供从简单聊天机器人到完整认证服务的各类实现案例

核心功能模块路径：

• 服务器实现：src/mcp/server/
• 客户端工具：src/mcp/client/
• 认证系统：src/mcp/server/auth/

快速安装步骤

准备工作

确保系统已安装：

• Python 3.7 或更高版本
• pip 包管理器
• Git 版本控制工具

一键安装流程

1. 克隆项目仓库

git clone https://gitcode.com/gh_mirrors/pythonsd/python-sdk
cd python-sdk

2. 安装依赖包

pip install .

3. 验证安装

mcp --version

如果一切正常，将显示当前 SDK 版本号 ✅

构建第一个 MCP 服务器

极简示例：创建加法工具服务

创建 server.py 文件，输入以下代码：

from mcp.server.fastmcp import FastMCP

# 初始化 MCP 服务器实例
mcp = FastMCP("简易计算器服务")

# 定义工具函数
@mcp.tool()
def add(a: int, b: int) -> int:
    """计算两个整数的和"""
    return a + b

# 启动服务器
if __name__ == "__main__":
    mcp.run()

运行服务

python server.py

服务器将默认在本地 8000 端口启动，现在你已经拥有一个可以处理加法请求的 MCP 服务 🎉

探索丰富示例项目

MCP Python SDK 提供了多种场景的示例代码，帮助你快速掌握不同功能：

客户端示例

• 简单认证客户端：examples/clients/simple-auth-client/
• AI 聊天机器人：examples/clients/simple-chatbot/

服务器示例

• 认证服务：examples/servers/simple-auth/
• 分页服务：examples/servers/simple-pagination/
• 工具调用服务：examples/servers/simple-tool/

FastMCP 快速开发示例

FastMCP 模块提供了更高层次的抽象，加速开发流程：

• 进度条与日志：examples/fastmcp/logging_and_progress.py
• 结构化输出：examples/fastmcp/weather_structured.py
• 工具调用演示：examples/fastmcp/direct_call_tool_result_return.py

深入学习资源

官方文档

完整文档位于项目的 docs 目录：

• API 参考：docs/api.md
• 安装指南：docs/installation.md
• 测试方法：docs/testing.md

源码结构解析

核心代码组织清晰，便于理解和扩展：

src/mcp/
├── client/        # 客户端实现
├── server/        # 服务器框架
│   ├── auth/      # 认证相关组件
│   └── fastmcp/   # 快速开发工具
└── shared/        # 共享工具和类型定义

常见问题解决

端口占用问题

如果启动服务器时提示端口被占用，可以指定其他端口：

mcp.run(port=8080)

依赖冲突解决

建议使用虚拟环境隔离项目依赖：

python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows
pip install .

总结

MCP Python SDK 为构建 LLM 交互应用提供了标准化解决方案，无论是简单的工具服务还是复杂的 AI 应用，都能通过其直观的 API 快速实现。通过本文介绍的安装配置和示例项目，你已经掌握了使用 MCP SDK 的基础知识。立即开始构建你的第一个 AI 服务吧！

官方文档：docs/index.md 示例代码库：examples/

【免费下载链接】python-sdk The official Python SDK for Model Context Protocol servers and clients 项目地址: https://gitcode.com/gh_mirrors/pythonsd/python-sdk