协议版本: 2025-03-26
用户交互模型
MCP中的工具被设计为模型控制的,这意味着语言模型可以基于其上下文理解和用户的提示自动发现和调用工具。 然而,实现者可以通过任何适合其需求的界面模式公开工具—协议本身不强制要求任何特定的用户交互模型。能力
支持工具的服务器必须声明tools能力:
listChanged表示服务器是否会在可用工具列表更改时发出通知。
协议消息
列出工具
要发现可用工具,客户端发送tools/list请求。此操作支持分页。
请求:
调用工具
要调用工具,客户端发送tools/call请求:
请求:
列表变更通知
当可用工具列表发生变化时,声明了listChanged能力的服务器应该发送通知:
消息流
数据类型
工具
工具定义包括:name:工具的唯一标识符description:功能的人类可读描述inputSchema:定义预期参数的JSON模式annotations:描述工具行为的可选属性
工具结果
工具结果可以包含不同类型的多个内容项:文本内容
图像内容
音频内容
嵌入资源
资源 可以被嵌入,以提供额外的上下文或数据,通过一个URI,客户端稍后可以订阅或再次获取:错误处理
工具使用两种错误报告机制:-
协议错误:标准JSON-RPC错误,用于以下问题:
- 未知工具
- 无效参数
- 服务器错误
-
工具执行错误:在工具结果中报告,带有
isError: true:- API失败
- 无效输入数据
- 业务逻辑错误
安全考虑
-
服务器必须:
- 验证所有工具输入
- 实施适当的访问控制
- 限制工具调用速率
- 净化工具输出
-
客户端应该:
- 对敏感操作提示用户确认
- 在调用服务器之前向用户显示工具输入,以避免恶意或意外的数据泄露
- 在传递给LLM之前验证工具结果
- 为工具调用实施超时
- 记录工具使用情况以供审计