🏓 MCP Ping-Pong Server with FastAPI

🏓 通过远程调用实现的 MCP 乒乓球服务

一个用于演示通过 FastAPI 调用 MCP（Model Context Protocol）的实验性教学乒乓球服务。

功能

• ✅ 使用 FastAPI/FastMCP 后端，通过 API 端点或 SSE 进行远程 MCP 调用
• 🔄 集成 MCP 以处理命令
• 🔐 线程安全的会话管理

快速开始

安装

要安装依赖项，请运行：

poetry install

1. 通过 API 调用 MCP 工具

运行服务

使用以下命令启动 FastAPI 服务：

python mcp-api-server.py

服务将在 http://localhost:8080 启动。

UI

在浏览器中打开 mcp-api-client.html，即可与 UI 交互。

API 端点

• GET /ping-pong?prompt_name=<prompt_name>：获取指定的提示词。
• POST /ping-pong：调用 MCP 工具命令（ping、pong、count）。

2. 通过 SSE 传输调用 MCP 工具

以下示例演示如何使用服务器发送事件（SSE）与 MCP 服务通信。

运行 SSE 服务

python mcp-sse-server.py

运行 SSE 客户端

python mcp-sse-client.py

示例输出

Type a command (e.g., 'ping', 'pong', 'count') or 'exit' to quit:
>>> ping
Sending command: ping
Result: pong
>>> pong
Sending command: pong
Result: ping
>>> count
Sending command: count
Result: 2

参考资料

• FastAPI SSE MCP
• MCP Weather SSE
• MCP Chinese Getting Started Guide

📄 许可证

MIT