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 許可證。