MCP Remote Call Ping Pong

🚀 🏓 乒乓球 MCP 遠程調用服務器

本項目是一個實驗性和教育性的乒乓球服務器，藉助 FastAPI 實現 MCP（模型上下文協議）遠程調用，為開發者展示了 MCP 遠程調用的實現方式。

✨ 主要特性

• ✅ 採用基於 FastAPI/FastMCP 的後端，支持通過 API 端點或 SSE（服務器發送事件）進行遠程 MCP 調用。
• 🔄 具備與 MCP 集成的命令處理功能，可高效處理各類相關命令。
• 🔐 實現了線程安全的會話管理，保障服務器運行的穩定性。

🚀 快速開始

📦 安裝指南

運行以下命令安裝所有依賴項：

poetry install

💻 使用示例

通過 API 調用 MCP 工具

啟動服務器

使用以下命令啟動 FastAPI 服務器：

python mcp-api-server.py

服務器將在 http://localhost:8080 上運行。

界面訪問

在瀏覽器中打開 mcp-api-client.html 文件，即可通過界面與乒乓球服務器交互。界面示例圖如下所示：

API 端點說明

• GET /ping-pong?prompt_name=<prompt_name>：獲取指定提示信息。
• POST /ping-pong：調用 MCP 工具命令（如 ping, pong, count）。

通過 SSE 運輸調用 MCP 工具

以下示例展示瞭如何使用服務器發送事件（SSE）與 MCP 服務器進行通信。

啟動 SSE 服務器

運行以下命令啟動 SSE 服務器：

python mcp-sse-server.py

啟動 SSE 客戶端

運行以下命令啟動 SSE 客戶端：

python mcp-sse-client.py

示例輸出

輸入一個命令（例如：ping, pong, count）或輸入 exit 退出：
>>> ping
發送命令：ping
結果：pong
>>> pong
發送命令：pong
結果：ping
>>> count
發送命令：count
結果：2

📚 詳細文檔

參考資料

• FastAPI SSE MCP
• MCP 天氣 SSE
• MCP 中文入門指南

📄 許可證

MIT