工具注解章程

​

组别类型

兴趣组

​

使命声明

工具注解兴趣组探索工具注解在整个 MCP 生态系统中如何帮助构建安全、可用的代理式系统。如今，有六项独立的 SEP 提议注解变更；它们各自解决了现实问题，但缺乏一个专门小组所能带来的连贯、贯穿全局的视角。该 IG 汇集来自服务器端和客户端作者的用例，评估现有和提议中的注解，并考虑注解模型的长期未来，包括运行时注解、工具响应注解以及其他扩展是否应纳入协议。

​

范围

​

范围内

• 现有注解的评估：评估当前工具注解集合（readOnlyHint、destructiveHint、idempotentHint、openWorldHint）是否足以满足服务器端和客户端作者的需求
• 提议注解的讨论：审阅并反馈提出新的或修改后的工具注解的 SEP（信任/敏感性、代理性、模型偏好等）
• 注解模型的未来：探讨是否值得将运行时注解、工具响应注解或注解系统的结构性变更纳入协议
• 用例收集：从服务器作者、客户端作者和主机应用中收集真实世界用例，以实际需求为依据做出注解决策
• 问题陈述与建议：为工作组或 SEP 作者提供关于注解设计、一致性和优先级的建议

​

范围外

• 规范性绑定变更：IG 产出的是建议，而非具有约束力的决定；规范变更通过 SEP 流程完成
• 实现工作：构建 SDK 功能或参考实现（可在 experimental repo 中探索，但这不是 IG 的主要目的）
• 非注解类工具变更：与注解无关的工具发现、调用或生命周期变更
• 资源注解：虽然相关，但资源级注解工作会单独跟踪，除非它直接与工具注解设计交叉

​

相关组别

• Security IG - 信任与敏感性注解 (SEP-1913) 横跨两个组的关注范围
• Skills Over MCP WG - 技能级元数据可能会与工具注解在发现和过滤方面发生交互

​

领导层

​

成员

​

运作

Discord: #tool-annotations-ig

​

讨论主题

以下 SEP 和主题构成了该 IG 的初始讨论议程。该列表并不详尽，并且会随着小组识别出新的关注领域而不断演进。

​

当前讨论中的活跃 SEP

​

未决问题

• 是否应将运行时注解（在多次调用之间变化的注解）加入协议？
• 是否值得标准化更多静态注解？哪些注解同时服务于服务器端和客户端作者？
• 是否应将工具 响应 注解加入协议？
• 注解应如何与信任、安全以及人类在回路中的需求相互作用？
• 合适的粒度级别是什么——少数定义明确的提示，还是更丰富、可扩展的词汇表？

​

资源

• 作为风险词汇的工具注解 - 介绍这项工作的动机的博客文章
• 实验性仓库 - 工具注解兴趣组的仓库

​

变更日志