Tool Annotations 兴趣组章程
Tool Annotations 兴趣组章程
社区译文；来源： MCP 29affa6b
小组类型
兴趣组
使命陈述
Tool Annotations 兴趣组探索工具注解在 MCP 生态系统中实现安全且易用的 Agent 系统时所发挥的作用。目前，有六项彼此独立的 SEP 提议更改注解，每项都在解决实际问题，但缺少专门小组能够提供的一致横切视角。IG 从服务器和客户端作者处收集用例，评估现有和拟议的注解，并考虑注解模型的长期未来，包括运行时注解、工具响应注解及其他扩展是否应纳入协议。
范围
范围内
- 评估现有注解：评估当前这组工具注解（
readOnlyHint、destructiveHint、idempotentHint、openWorldHint）是否足以满足服务器和客户端作者的需求 - 讨论拟议注解：评审提议新增或修改工具注解的 SEP，并提供反馈（信任/敏感性、自主性、模型偏好及其他方面）
- 注解模型的未来：探索是否值得将运行时注解、工具响应注解或注解系统的结构性变更加入协议
- 收集用例：从服务器作者、客户端作者和 host 应用收集真实用例，使注解决策以实际需求为依据
- 问题陈述与建议：就注解设计、一致性和优先级向工作组或 SEP 作者提出建议
范围外
- 具约束力的规范变更：IG 产出建议，不作具约束力的决定；规范变更通过 SEP 流程作出
- 实现工作：构建 SDK 功能或参考实现（可以在实验仓库中探索，但不是 IG 的主要目的）
- 与注解无关的工具变更：与注解无关的工具发现、调用或生命周期变更
- 资源注解：尽管两者相关，但资源级注解工作单独跟踪，除非它与工具注解设计直接交叉
相关小组
- Security IG - 信任和敏感性注解（SEP-1913）涉及两个小组的关注领域
- Skills Over MCP WG - Skill 级元数据可能在发现和筛选方面与工具注解交互
领导
| 角色 | 姓名 | 组织 | GitHub | 任期 |
|---|---|---|---|---|
| Facilitator | Sam Morrow | GitHub | @SamMorrowDrums | 初始 |
| Facilitator | Robert Reichel | OpenAI | @rreichel3 | 初始 |
成员
| 姓名 | 组织 | GitHub | Discord | 层级 |
|---|---|---|---|---|
| Sam Morrow | GitHub | @SamMorrowDrums | Facilitator | |
| Robert Reichel | OpenAI | @rreichel3 | Facilitator | |
| Matt Carey | Cloudflare | @mattzcarey | Participant | |
| Kapil Sharma | Microsoft | @kapil8811 | Participant | |
| Connor Peet | Microsoft | @connor4312 | Participant | |
| Ola Hungerford | Nordstrom | @olaservo | Participant | |
| Gökhan Arkan | GitHub | @gokhanarkan | Participant | |
| Joanna Krzek-Lubowiecka | GitHub | @joannakl | Participant | |
| Maxi Boch | Independent | @maxiboch | maxiboch | Participant |
运作方式
| 会议 | 频率 | 时长 | 目的 |
|---|---|---|---|
| 讨论 | TBD | TBD | 用例分享、注解评审和开放问答 |
Discord：#tool-annotations-ig
讨论主题
以下 SEP 和主题构成 IG 的初始讨论议程。此列表并非详尽无遗，并将随着该组发现新的关注领域而演进。
正在讨论的活跃 SEP
| SEP | 标题 | 状态 | 作者 |
|---|---|---|---|
| SEP-1862 | 工具解析（preflight 检查） | Draft | @SamMorrowDrums |
| SEP-1913 | 信任与敏感性注解 | Draft | @SamMorrowDrums, @rreichel3 |
| SEP-1984 | 全面的工具注解 | Draft | @sambhav |
| SEP-2417 | 工具的模型偏好 | Draft | @ProductOfAmerica |
开放问题
- 是否应将运行时注解（在不同调用之间发生变化的注解）加入协议？
- 是否值得标准化更多静态注解，其中哪些能同时服务服务器和客户端作者？
- 是否应将工具_响应_注解加入协议？
- 注解应如何与信任、安全和 human-in-the-loop 要求交互？
- 合适的粒度是什么——少量定义明确的提示，还是更丰富、可扩展的词汇表？
资源
- Tool Annotations as Risk Vocabulary - 说明这项工作动机的博客文章
- 实验仓库 - Tool Annotations 兴趣组仓库
变更日志
| 日期 | 变更 |
|---|---|
| 2026-04-20 | 初始章程 |