MCP Fastapi Ping Pong

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

本項目是一個實驗性和教育性的乒乓球服務器，旨在演示如何通過 FastAPI 進行遠程 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/FastMCP 後端實現遠程 MCP 調用，支持 API 端點或 SSE 通信
• 🔄 MCP 集成命令處理功能
• 🔐 線程安全的會話管理

📚 詳細文檔

📖 參考資料

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

📄 許可證

本項目採用 MIT 許可證。