ragcode-sse

此技能為 AI 代理程式與 RagCode MCP (Model Context Protocol) 伺服器整合提供了強大的架構指南，並採用原生的 Server-Sent Events (SSE) 傳輸層。專為開發人員與 AI 工程師設計，旨在跳過傳統的設定要求，在代理程式與 RagCode 架構之間建立直接且輕量級的 HTTP 通訊流。透過實作 SSE 交握與 JSON-RPC 訊息傳遞序列，使用者可以實現無縫的工具呼叫與資料擷取，確保高效能與可靠的狀態管理，無需額外的常駐二進位檔案或本機設定檔開銷。

• 啟用透過 HTTP GET 與 POST 方法直接連接，並利用標準 /sse 端點進行即時雙向訊息傳遞。

• 提供經過驗證的步驟式交握程序，包含 'initialize' 與 'notifications/initialized' 方法。

• 包含 Bash (curl)、Python (使用 sseclient) 的完整程式碼範例，以及用於工具執行的通用 JSON-RPC 酬載。

• 透過 'tools/list' 與輸入綱要驗證，促進細粒度的工具探索，以執行精確的程式碼搜尋作業。

• 透過利用 'endpoint' 事件動態提取會話特定的 POST URL，簡化錯誤處理與會話管理。

• 請確保始終提供 'Accept: text/event-stream' 標頭，以維持持續的 SSE 連線。

• 在嘗試任何 'tools/call' 作業之前，務必執行完整的 MCP 交握序列，以避免會話狀態錯誤。

• 使用 JSON-RPC 酬載中的唯一 'id' 欄位來匹配請求與回應，以確保執行緒安全的非同步通訊。

• SSE 連線必須在任務生命週期內保持開啟，以便接收伺服器的非同步事件更新。

• 適用於工作區索引自動化、程式碼檢索以及需要與 RagCode 進行低延遲通訊的代理工作流程。