用途:在基于 SDK 的项目中统计所有 MCP 工具,并按集合给出明细;当项目根目录存在 .discover.json 时,还会比较预期集合与实际实现,输出缺口分析。适合回答“我们有多少工具”“各集合工具分布”“项目进度/覆盖率”“哪些集合还缺测试或 eval”等问题。
主要能力:统计工具总数;按集合字母序分组;可列出每个集合的工具名;生成缺口分析表,逐集合检查工具目录是否存在且有工具文件、是否有集成测试文件 {TOOLS_DIR}/{collection}/tests/.test.ts、是否有匹配 {EVALS_DIR}/{collection}*.test.ts 的 eval 文件,并给出 Complete、Missing evals、Not started 等状态及端点覆盖率汇总。
使用方式:在消费项目根目录运行 npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/count-mcp-tools/scripts/count-tools.ts。显示工具名:SHOW_TOOLS=true npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/count-mcp-tools/scripts/count-tools.ts。保存报告:OUTPUT_FILE=docs/analysis/api-endpoints-analysis.md npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/count-mcp-tools/scripts/count-tools.ts。
环境变量:TOOLS_DIR 默认 src/umbraco-api/tools;OUTPUT_FILE 可选;SHOW_TOOLS 默认 false;PROJECT_ROOT 默认 .;EVALS_DIR 默认 tests/evals;API_GENERATED_DIR 默认 src/umbraco-api/api/generated。
限制:仅统计包含 ToolDefinition 与 withStandardDecorators 的 TypeScript 文件,排除 index.ts、测试文件及助手/工具文件;缺口分析仅在存在 .discover.json 时进行。收费、平台要求等未提供。