MCP Ping Server
2025.03.14
0
JavaScriptMCP 协议演示SSE 实现其它
mcp-ping 是一个基于 Server-Sent Events (SSE) 实现的简单 MCP (Model Context Protocol) 服务器，提供基本的 "ping" 工具，响应 "pong"。该项目展示了使用 SSE 进行通信的最小 MCP 服务器实现，可用于实时服务器到客户端的消息传递。
View on GitHub
Overview
基本能力
产品定位
mcp-ping 是一个演示性质的 MCP 服务器，主要用于展示如何使用 SSE 实现基本的 MCP 协议通信。
核心功能
- 实现简单的 "ping" 工具，响应 "pong"
- 基于 SSE 的实时服务器到客户端通信
- HTTP POST 端点用于客户端到服务器通信
- 健康检查端点用于监控
适用场景
- MCP 协议的学习和演示
- 实时通信的简单实现示例
- SSE 技术的研究和测试
MCP 工具列表
- ping
- 功能：简单的工具，当被调用时响应 "pong"
- 参数：无
- 响应示例：
json { "content": [ { "type": "text", "text": "pong" } ] }
常见问题解答
- SSE 连接问题
- 解决方案：确保反向代理禁用压缩，对于 Cloudflare 设置为 "DNS Only" 模式
- 超时设置：确保代理超时设置足够长（至少 120 秒）
使用教程
使用依赖
- Node.js 18 或更高版本
- npm 或 yarn
安装教程
-
克隆仓库并安装依赖：
bash git clone https://github.com/yourusername/mcp-ping.git cd mcp-ping npm install -
本地运行：
bash npm start服务器将在 http://localhost:3001 可用 -
Docker 部署：
bash docker build -t mcp-ping . docker run -p 3001:3001 mcp-ping或使用 Docker Compose:bash docker-compose up
调试方式
-
健康检查端点：
bash curl http://localhost:3001/health应返回 "OK" 表示服务器正常运行 -
使用 MCP Inspector 测试：
bash npx @modelcontextprotocol/inspector --sse-url https://your-domain.com/sse