SuperAPI AI 工具集

Update MCP Spec Version

智能体与模型

查看项目

更新于 10-15 20:32

技能介绍

用途:指导在 dart_mcp 包中升级所支持的 Model Context Protocol(MCP)规范版本,使代码与新规范对齐。

主要步骤:先阅读新版本规范,获取 changelog、schema 与规范文档,识别新增类型、字段、弃用项和新功能;必须以真实 schema 或规范文本为准,不得凭空发明 API 或基于不完整信息假设变更,找不到 schema 时应暂停并询问用户。

更新协议版本:编辑 pkgs/dart_mcp/lib/src/api/api.dart,向 ProtocolVersion 枚举添加新版本(如 vYYYY_MM_DD('YYYY-MM-DD')),并更新 ProtocolVersion.latestSupported。

更新文档链接:在代码库中搜索旧规范版本字符串(如 2024-11-05)或正则 specification/\d{4}-\d{2}-\d{2},更新注释中的 URL,重点文件包括 pkgs/dart_mcp/lib/src/client/sampling_support.dart、pkgs/dart_mcp/lib/src/server/server.dart、pkgs/dart_mcp/README.md。

实现 schema 变更:对照 schema 检查 lib/src/api/api.dart 包含的各 part 文件,新特性通常新增 part 文件;引用 map 键时使用 lib/src/utils/names.dart 中的常量,不使用字符串字面量;数值字段用 num(可选用 num?),除非 schema 明确限定为整数。

更新客户端/服务端实现:参考 pkgs/dart_mcp/lib/src/client/ 与 pkgs/dart_mcp_server/lib/src/server/ 下的支持文件,实现新特性时更新 initialize 中的 capabilities。

更新示例与测试:在 pkgs/dart_mcp/example/ 下更新或新增示例;为新特性编写测试,参考现有测试风格,保持良好覆盖,可补充缺失测试。

验证:在 pkgs/dart_mcp 与 pkgs/dart_mcp_server 中运行测试确保无回归,运行更新后的示例,运行 dart formatter 与 analyzer 保证格式与 lint 通过,并向用户说明所有改动与理由。

更新版本与 CHANGELOG:编辑 pkgs/dart_mcp/pubspec.yaml 按是否破坏性变更更新版本;在 pkgs/dart_mcp/CHANGELOG.md 添加版本条目,说明升级到新 MCP 规范版本及相关变更,破坏性变更以 Breaking: 开头。最后更新本技能,补充实际执行的额外步骤或经验。

限制:所有变更必须由真实 schema/规范支持;未提供具体规范版本、schema 内容或命令输出。