🚀 🏓 乒乓球 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