用途：为现有项目规划 MCP 服务器前，扫描代码库找出适合暴露为 MCP 工具的函数、REST 端点、CLI 命令和数据访问模式，并输出结构化工具规范文档，可交给 scaffold-mcp-server 使用。
主要能力：按目录与文件角色（入口、核心逻辑、数据访问、工具函数）分类整理；用 Glob 和 Grep 提取导出函数、公共 API、路由及元数据（名称、签名、返回类型、文档、位置）；对候选按输入契约、输出可预测性、副作用、幂等性、执行时间和错误处理打分（1-5），保留 3 分及以上者；按分类设计工具规范，含参数 schema、副作用、预估延迟和依赖关系；生成 mcp-tool-spec.yml（可选 md）；若提供现有 MCP 服务器，加入差距分析。
使用方式：需提供代码库根目录路径与目标语言；可选提供现有 MCP 服务器代码、领域聚焦、最大推荐工具数（默认 20）。流程为扫描结构、识别函数与端点、评估 MCP 适合度、设计工具规范、生成文档。
适用场景：为项目规划 MCP 服务器、打包第三方库为 MCP 工具前评估、审计代码库可暴露能力、与现有 MCP 实现对比。
限制：代码库超过约 10000 个文件需缩小范围；动态语言可能缺少类型标注，需推断并标记不确定项；存在隐式认证依赖的函数经 MCP 调用可能失败；副作用明显的函数或需大量包装的函数不适合；若候选多数低于 3 分，应输出改造建议文档而非工具规范。工具命名需符合 snake_case 且唯一。