MCP Ectors

🚀 企業級MCP SSE服務器（mcp - ectors）介紹

本項目是一個專為企業設計的高性價比、可擴展且易於使用的平臺。它旨在通過行為體（actors）、Rust語言和簡潔的多路由器管理架構，簡化大型語言模型（LLMs）與工具及資源的集成，助力實現先進的代理式AI工作流程。

🚀 快速開始

本項目暫未提供快速開始的相關內容，你可以參考後續的架構概述、未來開發計劃等內容瞭解項目詳情。

✨ 主要特性

• 高性價比：專為企業設計，以合理的成本提供強大的功能。
• 可擴展性：通過多路由器管理架構，能夠靈活支持各種功能擴展。
• 易於使用：簡化了大型語言模型與工具及資源的集成過程。

📚 詳細文檔

架構概述

1. 服務器構建者
   • server_builder負責確定傳輸層。目前支持SSE（服務器發送事件），未來版本將加入stdio和wasi傳輸。
   • 當前版本僅支持SSE作為客戶端與服務器間通信的媒介。
2. 路由器服務管理器
   • RouterServiceManager負責註冊多個路由器，並確保每個路由器能夠獨立處理請求，無需新建連接。
   • 該架構允許在同一連接下部署多個路由器，顯著提升了系統的高效性和擴展性。
3. 日誌配置
   • 服務器可配置為將日誌存儲在指定目錄，支持自定義日誌級別（如INFO、DEBUG等）以便監控和調試。
   • 示例配置：

let log_config = LogConfig {
    log_dir: "logs".to_string(),
    log_file: "server.log".to_string(),
    level: Level::INFO,
};

4. 傳輸角色
   • 任何用於MCP服務器的傳輸都需要實現TransportActorTrait。該特性確保了不同傳輸方式（如SSE、stdio、wasi）能夠正確處理請求和消息。
   • 關鍵消息類型：
     • TransportRequest：允許將新的JsonRPCMessages發送給客戶端，負責服務器與客戶端間的通信。
     • StartTransport：用於啟動特定傳輸層，初始化相關後臺任務（如建立連接或等待入站消息）。
     • StopTransport：用於停止傳輸層，優雅地關閉任何活動連接或關聯的任務。
5. 路由器
   • Router是一個需要由所有路由器實現的特徵接口，緊密圍繞MCP標準設計。通過RouterRegistry註冊新路由後，每條路由都會被封裝在特定的RouterActor中，負責處理對應的功能請求。
   • 例如，當收到tools/call請求時，持有相應路由器的RouterActor將根據預設邏輯進行響應。這種動態響應機制使服務器能夠靈活支持各種功能擴展。
6. 標準行為體
   • MCP定義了一系列標準行為體，負責實現諸如初始化和工具、提示、資源管理等基礎功能。
   • 這些標準行為體承擔著處理初始請求和響應列表請求（如工具、提示、資源的列舉）的任務。這使得與這些核心組件交互變得統一且規範。

未來開發計劃

• MCP協議擴展：當前已實現基本功能，但通知機制仍在規劃中。此外，未來的版本還將支持認證/授權、錯誤處理和日誌記錄等功能。
• 傳輸擴展：計劃增加對stdio和wasi的支持，豐富服務器的通信方式。
• 尋求幫助：歡迎社區貢獻代碼或提供反饋。若發現任何問題，請通過以下鏈接提交：[GitHub](https://github.com/your - repository) ，聯繫人：張三

如何貢獻

我們熱烈歡迎開源社區的積極參與！您可以通過以下方式貢獻力量：

1. 報告問題：在GitHub倉庫中提交Issue。
2. 功能開發：fork倉庫，在新的分支中實現新功能。
3. 代碼審查：參與現有Pull Request的評審工作。

聯繫我們

• 郵箱：Enterprise Support Team
• 電話：+86 - 010 - 12345678

加入我們，一起推動AI技術的發展！