Sse MCP Server

🚀 SSE MCP 服务器

此项目是一个借助 Server-Sent Events (SSE) 实现 Model Context Protocol (MCP) 的服务器端示例。其设计初衷是便于在 Netlify Edge Functions 上进行部署，能为开发者提供高效的实时通信解决方案。

🚀 快速开始

开发环境搭建

1. 克隆仓库

   git clone https://github.com/yourusername/sse-mcp-server.git
   cd sse-mcp-server
   

2. 安装依赖项

   npm install
   

3. 启动开发服务器

   npm run dev
   

部署到 Netlify

1. 安装 Netlify CLI（若尚未安装）

   npm install -g netlify-cli
   

2. 登录 Netlify

   netlify login
   

3. 初始化站点（仅限首次）

   netlify init
   

4. 部署

   npm run deploy
   

部署到 Netlify 后的验证步骤

部署完成后，可按以下步骤验证服务器是否正常运行：

1. 访问部署的网站 URL
   • 部署完成时，控制台会显示 URL，也可在 Netlify 仪表盘中查看。
   • 示例：https://your-site-name.netlify.app
2. 访问主页后，您将看到消息：“SSE MCP Server 正常运行。访问 /sse 连接。”
   • 这表明服务器已正常启动。
3. 使用示例页面测试 SSE 连接
   • 主页（index.html）提供了用于测试 SSE 连接的用户界面。
   • 点击“连接”按钮以连接到 SSE 服务器。
   • 成功连接后，状态将显示为“连接中”，并显示连接 ID。
4. 测试消息的收发
   • 在文本输入框中输入消息，然后点击“发送”按钮。
   • 发送的消息将由服务器返回，并在屏幕上显示。
5. 确认以下内容：
   • 状态是否正确显示
   • 是否能定期接收 ping 消息
   • 消息的收发是否正常进行
   • 错误处理是否恰当
6. 若有需要，可使用开发者工具（F12）的网络选项卡详细检查 SSE 连接
   • 查看 /sse 端点的请求和事件流状态。
   • 确认 /message 端点的 POST 请求是否正常处理。

以上验证步骤全部完成且无误，即表示服务器运行正常，用户可顺利进行连接和消息收发。

✨ 主要特性

• 运用 SSE 技术实现实时通信，确保数据的及时传输。
• 实现了在 Netlify Edge Functions 上的服务器端部署，具备良好的可扩展性。
• 提供简单的客户端界面，方便开发者进行测试和使用。

📦 安装指南

具体安装步骤请参考上述“快速开始”部分的开发环境搭建和部署到 Netlify 的相关内容。

📚 详细文档

最新更新

• 2025/3/11：修复了 Netlify Edge Functions 中的 502 错误，并添加了定期发送 ping 消息的功能以保持 SSE 连接。

文件结构

• everything.ts：关键逻辑文件，包含 MCP 协议的核心实现。
• sse.ts：SSE 相关的逻辑实现。
• 其他文件：用于支撑整个项目的配置和界面实现。

📄 许可证

本项目采用 MIT 许可证。