用途:向已有的 MCP 工具集合中添加一个或多个新工具。适用情形包括新增 API 端点需要暴露为工具、从已有集合暴露更多操作,或 /build-tools 因集合已有 index.ts 而跳过。
前提:集合已存在(src/umbraco-api/tools/{collection}/index.ts);API 客户端已生成(src/umbraco-api/api/generated/ 存在,否则运行 npm run generate);项目可编译(npm run compile)。
参数:集合名(必填,如 /add-tool form);操作提示(可选,如 /add-tool form "copy form endpoint")。未提供参数时需询问用户集合与端点。
用法流程:读取现有集合以匹配模式(导入风格、API 客户端用法、命名约定);从 .discover.json 的 swaggerUrl 获取 spec(curl -sk {swaggerUrl}),找到对应操作的方法、路径、operationId、参数与响应;用 mcp-tool-creator 与 mcp-tool-description-writer 创建工具文件;在 index.ts 中加导入并加入 tools 数组,编译 npm run compile;用 mcp-tool-reviewer 仅审查新工具;若有集成测试则用 integration-test-creator 创建 tests/{action}-{entity}.test.ts,编译并运行 npm test -- tests/{collection}/{action}-{entity}.test.ts;若有 eval 测试则按现有场景更新或新建,运行 npm run build 与 npm run test:evals -- --testPathPatterns="{collection}"。
关键规则:一次只做一个工具,逐个创建、编译、验证;编译和测试须分开运行 Bash,不得用 && 串联;不重建已有基础设施,只新增文件并更新已有文件。
文件结构:新工具位于 src/umbraco-api/tools/{collection}/{method}/{action}-{entity}.ts,同时更新 index.ts,测试位于 tests/。注意:本技能依赖多个自定义 agent,未提供时相关步骤可能无法执行。