sage-mcp-protocol

sage-mcp-protocol 模組為 Sage agent 提供了模型上下文協議 (MCP) 的完整原生 Rust 實現。此技能使代理程式能夠與外部 MCP 伺服器無縫互動，將其能力擴展至本地檔案系統與 Shell 操作之外。它作為代理程式核心執行引擎與日益增長的工具、資源與提示生態系之間的強大橋樑，實現了第三方服務與專業資料來源的動態整合。

• 完整實作 MCP 生命週期管理，包含初始化、能力協商與通知處理。

• 支援多種傳輸層，例如用於本地處理程序的 Stdio 與用於網路工具伺服器的 HTTP。

• 整合了服務發現、健康監控與連線管理，用於自動化的 MCP 伺服器編排。

• 內建 Schema 轉換層，確保外部工具定義與代理程式內部工具執行環境之間的互通性。

• 針對工具、資源與提示的進階快取系統，最大限度地減少工具執行與元資料檢索時的延遲。

• 符合 2024-11-05 MCP 規範版本的原生 JSON-RPC 訊息處理。

• 適用於建構可擴充 AI 代理程式的開發人員與工程師，需要連線至自定義資料獲取、API 查詢或專業運算 MCP 伺服器。

• 輸入通常涉及識別並連線至 MCP 伺服器端點（Stdio 路徑或 URL），輸出則為一系列可供代理程式呼叫的可用工具、資源與提示模板。

• 實際應用包含自動化發現可用資源、透過通知處理器保持快取更新，以及處理非同步請求週期中的錯誤。

• 操作時嚴格遵守 JSON-RPC 2.0 標準，確保與標準 MCP 相容伺服器的高度相容性。

• 限制條件包括依賴於底層傳輸層的連線穩定性；基於網路的 HTTP 傳輸需要根據特定伺服器實現的支援，正確配置基礎 URL 與認證憑據。