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 进行低延迟通讯的代理工作流程。