MCP Demo

🚀 🧠 模型上下文協議（MCP）示例——Python實現

本倉庫提供了一個簡潔且功能完備的模型上下文協議 (MCP) Python 實現示例。它展示瞭如何藉助基於 HTTP 的JSON-RPC客戶端 - 服務器接口，實現大型語言模型 (LLM) 代理與企業系統的通信，同時支持服務器發送事件 (SSE)。

您可閱讀此博客深入瞭解該主題：https://srivatssan.medium.com/model-context-protocol-exhaustively-explained-f5a30a87a3ff?sk=1b971265640303c66b04377371c82102

🚀 快速開始

運行示例步驟

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/ 支持

📦 安裝指南

服務器端

需安裝 FastAPI 和 Uvicorn：

pip install fastapi uvicorn

客戶端

需安裝 Python requests 包：

pip install requests

💻 使用示例

基礎用法

啟動服務器

cd server
uvicorn main:app --reload

運行客戶端

cd client
python main.py

📚 詳細文檔

這裡演示了什麼

• 基本 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 創建