MCP Hub

🚀 MCP 中心

MCP 中心是一個用於協調客戶端與多個 MCP 服務器之間通信的中心繫統。它通過提供統一的接口來管理工具、資源和提示請求，併為每個 MCP 服務器維護最新的能力信息，極大提升了通信管理的效率和便捷性。

🚀 快速開始

事件

MCP 中心支持以下主要事件：

• hub.start：表示 MCP 中心啟動
• hub.stop：表示 MCP 中心停止
• server.connected：表示 MCP 服務器連接到中心
• server.disconnected：表示 MCP 服務器從中心斷開
• tool.request：客戶端請求工具執行
• resource.request：客戶端請求資源訪問
• prompt.request：客戶端請求提示處理
• error.log：記錄錯誤事件

架構概述

MCP 中心的架構設計包含以下幾個關鍵部分：

1. 啟動和 MCP 服務器連接
   • 啟動 MCP 中心並初始化配置。
   • 嘗試連接到所有配置的 MCP 服務器。
2. SSE 客戶端連接處理
   • 處理客戶端的 Server-Sent Events 連接。
   • 發佈 MCP 中心的狀態更新，如啟動、停止等。
3. 工具和資源請求路由
   • 驗證客戶端請求的有效性。
   • 將請求路由到合適的 MCP 服務器進行處理。
   • 處理來自 MCP 服務器的響應或錯誤。
4. MCP 服務器健康監控
   • 定期檢查 MCP 服務器的連接狀態和能力信息。
   • 在檢測到故障時嘗試重新連接。
5. 優雅啟動和關閉流程
   • 管理 MCP 中心的啟動和停止操作。
   • 在關閉過程中通知所有客戶端。

請求處理

MCP 中心處理工具、資源和提示請求的標準流程如下：

1. 請求驗證
   • 驗證客戶端請求的有效性和完整性。
   • 檢查目標 MCP 服務器是否連接狀態正常。
2. 路由請求到 MCP 服務器
   • 根據請求類型選擇合適的 MCP 服務器進行處理。
   • 發送經過加密和簽名的請求到目標服務器。
3. 響應處理和錯誤管理
   • 接收來自 MCP 服務器的響應或錯誤信息。
   • 將結果返回給客戶端，並在發生錯誤時記錄日誌。

📦 安裝指南

基礎設施

依賴項

• Node.js 版本要求：18.0.0 或更高版本
• mcp-marketplace 庫：用於提供 MCP 服務器市場的功能

市場集成

MCP 中心目前依賴於 mcp-marketplace 庫來實現市場功能。該庫提供了以下主要功能：

1. 服務器註冊
   • 允許 MCP 服務器在中心進行註冊。
   • 提供 API 接口用於管理服務器列表。
2. 能力驗證
   • 驗證 MCP 服務器的能力是否符合要求。
   • 維護最新的服務器能力信息。
3. 請求路由
   • 根據客戶端的請求匹配最合適的 MCP 服務器。
   • 管理請求的分發和響應收集。
4. 監控與告警
   • 實現對 MCP 服務器健康狀態的即時監控。
   • 在檢測到故障時觸發告警機制。

📄 待辦事項

• 實現市場功能：完成 MCP 中心對 mcp-marketplace 的集成
• 增加錯誤處理：完善請求處理中的錯誤捕獲和恢復邏輯
• 優化性能：提升大規模併發情況下的處理能力
• 添加日誌記錄：引入詳細的日誌系統以方便調試和監控

🙏 致謝

感謝以下項目和技術對 MCP 中心開發的貢獻：

• mcp-marketplace 庫：提供了強大的市場功能支持
• Node.js 團隊：提供了高效穩定的運行環境
• 開源社區：為項目的持續發展提供了寶貴的建議和支持