概览

通过 MCP Server接入，当用户 Query 符合 MCP Tool 的能力描述时，Agent 将自动调用对应的 MCP Tool，从而实现工具能力的动态接入与复用。

使用说明

• 暂时支持单mcp server配置，即1个 Agent实例 暂不支持同时接入多个mcp server。
• 支持实例级（Instance Level）配置：在创建具体智能体实例时指定。 创建互动实例接口参数: 创建大模型互动实例

协议实现

• 支持SSE和HttpStreamable, 推荐使用HttpStreamable。
• 服务端需实现 initialize、tools/list 和 tools/call 三个核心指令。可参考文档: https://modelcontextprotocol.io/docs/learn/architecture
• 协议交互字段格式见mcp官网描述: MCP Schema

响应格式要求

• TTS 兼容性：目前仅支持 text 类型的 Content。
• 示例：

1{
2  "content": [{ "type": "text", "text": "这是给用户播报的内容" }]
3}

MCP Tools更新机制

系统目前暂不支持 MCP 标准的 Notification 自动通知机制 。若工具配置有变更，需通过以下方式手动触发 Agent 更新

• 服务端触发：通过 大模型互动实例发消息给sdk 接口 发送指令 [E]:[CMD]:[MCP_TOOLS_CHANGED] 。
• SDK 触发：客户端通过 SDK 发送事件消息 [E]:[CMD]:[MCP_TOOLS_CHANGED]。

限制与约束

为了防止客户的 MCP Server 拖慢 Agent 响应：

• 超时限制： tools/list 必须在 3s 内返回，tools/call 必须在 10s 内返回。
• 响应体大小：因为文本要转 TTS，建议限制单次返回的最大字符数（如 500 字以内），避免播报过长。

工具开发最佳实践

• mcp server 开发推荐使用 mcp sdk。 https://github.com/modelcontextprotocol
• 工具名称(Tool Name): 请尽量使用动宾结构，例如: getweather，open_airconditioner
• 描述词 (Description)：请使用清晰的中文描述，例如“查询广州当天的天气情况”，"打开空调"。 触发mcp工具口令词列表可以放在description最后一行，用call_examples: 口令1, 口令2 表示,用半角符号,分割。 比如: call_examples: 打开空调,调到25度
• 参数设计：尽量使用枚举值来限制 LLM 的幻觉，参数数量不宜过多。 如需要设备ID，需要添加参数对应描述。设备ID通过指令传入: [E]:[LIC]:[ACTIVE]: https://cloud.baidu.com/doc/RTC/s/sm9qgxvfq

MCP 交互时序