🧠 模型上下文协议（MCP）示例——Python实现

此仓库提供了一个简洁但功能齐全的模型上下文协议 (MCP) 示例，使用 Python 实现。它展示了如何通过基于 HTTP 的JSON-RPC客户端-服务器接口，让大型语言模型 (LLM) 代理与企业系统进行通信，并且支持服务器发送事件 (SSE)。

您可以阅读我的博客以更好地理解该主题：https://srivatssan.medium.com/model-context-protocol-exhaustively-explained-f5a30a87a3ff?sk=1b971265640303c66b04377371c82102

📦 仓库结构

mcp-protocol-example/
├── client/
│   └── main.py       # Python MCP 客户端，使用 JSON-RPC
├── server/
│   └── main.py       # 基于 FastAPI 的 MCP 服务器，带 /rpc 和 /events 端点

🚀 如何运行此示例

1️⃣ 启动服务器

确保已安装 FastAPI 和 Uvicorn：

pip install fastapi uvicorn

然后启动 MCP 服务器：

cd server
uvicorn main:app --reload

这将启动一个 FastAPI 服务器，提供：

• POST /rpc：处理工具列表和调用的 JSON-RPC 处理器
• GET /events：模拟 SSE 端点，每 5 秒发出一次心跳消息

2️⃣ 运行客户端

安装所需的 Python requests 包：

pip install requests

然后运行客户端以与服务器交互：

cd client
python main.py

输出：

工具：[{'name': 'greet', 'description': 'Greets the user', ...}]
响应：{'message': 'Hello, Sri!'}

您可以在 http://localhost:8000/events 查看心跳事件，如下所示。

_data: {'event': 'heartbeat'}

data: {'event': 'heartbeat'} _ ...

⚙️ 这里演示了什么

• 基本 MCP 服务器通过 tools/list 和 tools/call 暴露工具
• 客户端发送 JSON-RPC 请求以列出和调用工具
• 使用 /events SSE 端点模拟实时连接
• 模块化结构，可扩展以支持 resources/ 和 prompts/ 支持

🧩 下一步

您可以通过以下方式扩展此原型：

• 添加更多工具，具有不同的模式
• 支持 resources/list 和 resources/read
• 管理提示模板，使用 prompts/get
• 实现身份验证和访问控制
• 处理从服务器到客户端的流式响应

📚 参考资料

• 模型上下文协议（官方站点）
• JSON-RPC 2.0 规范
• FastAPI 文档
• 服务器发送事件 (MDN)

由 ❤️ Srivatssan Srinivasan 创建