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 与认证凭据。