mcp-probe-kit 3.1.0 → 3.3.0

package/build/tools/start_api.js

@@ -1,193 +0,0 @@
-import { parseArgs, getString } from "../utils/parseArgs.js";
-/**
- * start_api 智能编排工具
- *
- * 场景：API 开发
- * 编排：[检查上下文] → genapi → gen_mock → gentest
- */
-const PROMPT_TEMPLATE = `# 🔌 API 开发编排指南
-
-## 🎯 目标
-
-为以下 API 代码生成完整的开发资料：
-
-\`\`\`{language}
-{code}
-\`\`\`
-
----
-
-## 📋 步骤 0: 项目上下文（自动处理）
-
-**操作**:
-1. 检查 \`docs/project-context.md\` 是否存在
-2. **如果不存在**：
-   - 调用 \`init_project_context\` 工具
-   - 等待生成完成
-3. **读取** \`docs/project-context.md\` 内容
-4. 了解项目的 API 规范、测试框架
-
----
-
-## 📝 步骤 1: 生成 API 文档
-
-**调用工具**: \`genapi\`
-
-**参数**:
-\`\`\`json
-{
-  "code": "[API 代码]",
-  "format": "{format}"
-}
-\`\`\`
-
-**生成内容**:
-- API 端点列表
-- 请求/响应格式
-- 参数说明
-- 示例
-
-**产出**: API 文档（Markdown/OpenAPI/JSDoc）
-
----
-
-## 🎭 步骤 2: 生成 Mock 数据
-
-**调用工具**: \`gen_mock\`
-
-**参数**:
-\`\`\`json
-{
-  "schema": "[从 API 代码中提取的数据结构]",
-  "count": 5,
-  "format": "json",
-  "locale": "zh-CN"
-}
-\`\`\`
-
-**生成内容**:
-- 请求示例数据
-- 响应示例数据
-- 各种场景的测试数据
-
-**产出**: Mock 数据文件
-
----
-
-## 🧪 步骤 3: 生成 API 测试
-
-**调用工具**: \`gentest\`
-
-**参数**:
-\`\`\`json
-{
-  "code": "[API 代码]",
-  "framework": "[根据项目上下文选择]"
-}
-\`\`\`
-
-**生成内容**:
-- 单元测试
-- 集成测试
-- 边界情况测试
-- 错误处理测试
-
-**产出**: 测试代码
-
----
-
-## ✅ 完成检查
-
-- [ ] 项目上下文已读取
-- [ ] API 文档已生成
-- [ ] Mock 数据已生成
-- [ ] 测试代码已生成
-
----
-
-## 📊 输出汇总
-
-完成后，向用户提供：
-
-### 1. API 文档
-
-\`\`\`markdown
-## API 端点
-
-### [METHOD] /path
-
-**描述**: ...
-
-**请求参数**:
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-
-**响应**:
-\`\`\`json
-{
-  "code": 0,
-  "data": {}
-}
-\`\`\`
-\`\`\`
-
-### 2. Mock 数据
-
-\`\`\`json
-[Mock 数据示例]
-\`\`\`
-
-### 3. 测试代码
-
-\`\`\`typescript
-[测试代码]
-\`\`\`
-
-### 4. 使用建议
-
-- Mock 数据可用于前端开发联调
-- 测试代码可直接运行验证 API
-- API 文档可分享给前端/调用方
-
----
-
-*编排工具: MCP Probe Kit - start_api*
-`;
-export async function startApi(args) {
-    try {
-        // 智能参数解析，支持自然语言输入
-        const parsedArgs = parseArgs(args, {
-            defaultValues: {
-                code: "",
-                language: "typescript",
-                format: "markdown",
-            },
-            primaryField: "code", // 纯文本输入默认映射到 code 字段
-            fieldAliases: {
-                code: ["source", "api", "代码", "endpoint"],
-                language: ["lang", "语言", "编程语言"],
-                format: ["output", "type", "格式", "输出格式"],
-            },
-        });
-        const code = getString(parsedArgs.code);
-        const language = getString(parsedArgs.language) || "typescript";
-        const format = getString(parsedArgs.format) || "markdown";
-        if (!code) {
-            throw new Error("缺少必填参数: code（API 代码）");
-        }
-        const guide = PROMPT_TEMPLATE
-            .replace(/{code}/g, code)
-            .replace(/{language}/g, language)
-            .replace(/{format}/g, format);
-        return {
-            content: [{ type: "text", text: guide }],
-        };
-    }
-    catch (error) {
-        const errorMsg = error instanceof Error ? error.message : String(error);
-        return {
-            content: [{ type: "text", text: `❌ 编排执行失败: ${errorMsg}` }],
-            isError: true,
-        };
-    }
-}

package/build/tools/start_doc.d.ts

@@ -1,13 +0,0 @@
-export declare function startDoc(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-}>;

package/build/tools/start_doc.js

@@ -1,207 +0,0 @@
-import { parseArgs, getString } from "../utils/parseArgs.js";
-/**
- * start_doc 智能编排工具
- *
- * 场景：文档生成
- * 编排：[检查上下文] → gendoc → genreadme → genapi
- */
-const PROMPT_TEMPLATE = `# 📖 文档生成编排指南
-
-## 🎯 目标
-
-为项目/代码生成完整的文档
-
-**输入内容**:
-\`\`\`
-{code}
-\`\`\`
-
----
-
-## 📋 步骤 0: 项目上下文（自动处理）
-
-**操作**:
-1. 检查 \`docs/project-context.md\` 是否存在
-2. **如果不存在**：
-   - 调用 \`init_project_context\` 工具
-   - 等待生成完成
-3. **读取** \`docs/project-context.md\` 内容
-4. 了解项目的文档风格、技术栈
-
----
-
-## 📝 步骤 1: 生成代码注释
-
-**调用工具**: \`gendoc\`
-
-**参数**:
-\`\`\`json
-{
-  "code": "[代码内容]",
-  "style": "{style}",
-  "lang": "{lang}"
-}
-\`\`\`
-
-**生成内容**:
-- 函数/方法注释
-- 参数说明
-- 返回值说明
-- 使用示例
-
-**产出**: 带注释的代码
-
----
-
-## 📄 步骤 2: 生成 README
-
-**调用工具**: \`genreadme\`
-
-**参数**:
-\`\`\`json
-{
-  "project_info": "[项目信息或代码]",
-  "style": "standard"
-}
-\`\`\`
-
-**生成内容**:
-- 项目简介
-- 功能特性
-- 安装使用
-- API 说明
-- 贡献指南
-
-**产出**: README.md
-
----
-
-## 🔌 步骤 3: 生成 API 文档（如适用）
-
-**调用工具**: \`genapi\`
-
-**参数**:
-\`\`\`json
-{
-  "code": "[API 相关代码]",
-  "format": "markdown"
-}
-\`\`\`
-
-**生成内容**:
-- API 端点列表
-- 请求/响应格式
-- 参数说明
-
-**产出**: API 文档
-
----
-
-## ✅ 完成检查
-
-- [ ] 项目上下文已读取
-- [ ] 代码注释已生成
-- [ ] README 已生成
-- [ ] API 文档已生成（如适用）
-
----
-
-## 📊 输出汇总
-
-完成后，向用户提供：
-
-### 1. 代码注释
-
-\`\`\`typescript
-/**
- * [函数描述]
- * @param {Type} param - [参数说明]
- * @returns {Type} [返回值说明]
- * @example
- * [使用示例]
- */
-\`\`\`
-
-### 2. README.md
-
-\`\`\`markdown
-# 项目名称
-
-## 简介
-...
-
-## 功能特性
-...
-
-## 快速开始
-...
-
-## API 文档
-...
-
-## 贡献指南
-...
-
-## 许可证
-...
-\`\`\`
-
-### 3. API 文档（如适用）
-
-\`\`\`markdown
-## API 参考
-...
-\`\`\`
-
-### 4. 文档清单
-
-| 文档 | 状态 | 位置 |
-|------|------|------|
-| 代码注释 | ✅ | 源代码中 |
-| README | ✅ | README.md |
-| API 文档 | ✅/- | docs/api.md |
-
----
-
-*编排工具: MCP Probe Kit - start_doc*
-`;
-export async function startDoc(args) {
-    try {
-        // 智能参数解析，支持自然语言输入
-        const parsedArgs = parseArgs(args, {
-            defaultValues: {
-                code: "",
-                project_info: "",
-                style: "jsdoc",
-                lang: "zh",
-            },
-            primaryField: "code", // 纯文本输入默认映射到 code 字段
-            fieldAliases: {
-                code: ["source", "src", "代码", "content"],
-                project_info: ["info", "project", "项目信息"],
-                style: ["format", "type", "风格", "注释风格"],
-                lang: ["language", "语言"],
-            },
-        });
-        const code = getString(parsedArgs.code) || getString(parsedArgs.project_info);
-        const style = getString(parsedArgs.style) || "jsdoc";
-        const lang = getString(parsedArgs.lang) || "zh";
-        if (!code) {
-            throw new Error("缺少必填参数: code 或 project_info");
-        }
-        const guide = PROMPT_TEMPLATE
-            .replace(/{code}/g, code)
-            .replace(/{style}/g, style)
-            .replace(/{lang}/g, lang);
-        return {
-            content: [{ type: "text", text: guide }],
-        };
-    }
-    catch (error) {
-        const errorMsg = error instanceof Error ? error.message : String(error);
-        return {
-            content: [{ type: "text", text: `❌ 编排执行失败: ${errorMsg}` }],
-            isError: true,
-        };
-    }
-}

package/build/tools/start_refactor.d.ts

@@ -1,13 +0,0 @@
-export declare function startRefactor(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-}>;

package/build/tools/start_refactor.js

@@ -1,188 +0,0 @@
-import { parseArgs, getString } from "../utils/parseArgs.js";
-/**
- * start_refactor 智能编排工具
- *
- * 场景：代码重构
- * 编排：[检查上下文] → code_review → refactor → gentest
- */
-const PROMPT_TEMPLATE = `# ♻️ 代码重构编排指南
-
-## 🎯 目标
-
-重构以下代码：
-
-\`\`\`
-{code}
-\`\`\`
-
-**重构目标**: {goal}
-
----
-
-## 📋 步骤 0: 项目上下文（自动处理）
-
-**操作**:
-1. 检查 \`docs/project-context.md\` 是否存在
-2. **如果不存在**：
-   - 调用 \`init_project_context\` 工具
-   - 等待生成完成
-3. **读取** \`docs/project-context.md\` 内容
-4. 了解项目的架构模式、编码规范
-5. 重构要符合项目规范
-
----
-
-## 🔍 步骤 1: 代码审查（发现问题）
-
-**调用工具**: \`code_review\`
-
-**参数**:
-\`\`\`json
-{
-  "code": "[待重构代码]",
-  "focus": "quality"
-}
-\`\`\`
-
-**目的**:
-- 识别代码坏味道
-- 发现可改进点
-- 评估当前代码质量
-
-**产出**: 问题清单
-
----
-
-## ♻️ 步骤 2: 生成重构方案
-
-**调用工具**: \`refactor\`
-
-**参数**:
-\`\`\`json
-{
-  "code": "[待重构代码]",
-  "goal": "{goal}"
-}
-\`\`\`
-
-**重构方向**:
-- improve_readability: 提高可读性
-- reduce_complexity: 降低复杂度
-- extract_function: 提取函数
-- remove_duplication: 消除重复
-- improve_naming: 改进命名
-
-**产出**: 重构后的代码 + 重构说明
-
----
-
-## 🧪 步骤 3: 生成保护测试
-
-**调用工具**: \`gentest\`
-
-**参数**:
-\`\`\`json
-{
-  "code": "[重构后的代码]",
-  "framework": "[根据项目上下文选择]"
-}
-\`\`\`
-
-**目的**:
-- 确保重构不改变行为
-- 为重构后的代码提供测试保护
-- 覆盖主要功能和边界情况
-
-**产出**: 测试代码
-
----
-
-## ✅ 完成检查
-
-- [ ] 项目上下文已读取
-- [ ] 代码问题已识别
-- [ ] 重构方案已生成
-- [ ] 代码已重构
-- [ ] 测试已添加
-- [ ] 测试已通过
-
----
-
-## 📝 输出汇总
-
-完成后，向用户提供：
-
-### 1. 重构前后对比
-
-**重构前**:
-\`\`\`
-[原代码]
-\`\`\`
-
-**重构后**:
-\`\`\`
-[新代码]
-\`\`\`
-
-### 2. 改进说明
-
-| 改进项 | 说明 |
-|--------|------|
-| [改进1] | [说明] |
-| [改进2] | [说明] |
-
-### 3. 测试覆盖
-
-- 测试用例数: X
-- 覆盖场景: [列出]
-
-### 4. 注意事项
-
-- [重构可能影响的地方]
-- [需要同步修改的地方]
-
----
-
-*编排工具: MCP Probe Kit - start_refactor*
-`;
-export async function startRefactor(args) {
-    try {
-        // 智能参数解析，支持自然语言输入
-        const parsedArgs = parseArgs(args, {
-            defaultValues: {
-                code: "",
-                goal: "improve_readability",
-            },
-            primaryField: "code", // 纯文本输入默认映射到 code 字段
-            fieldAliases: {
-                code: ["source", "src", "代码", "content"],
-                goal: ["target", "objective", "目标", "重构目标"],
-            },
-        });
-        const code = getString(parsedArgs.code);
-        const goal = getString(parsedArgs.goal) || "improve_readability";
-        if (!code) {
-            throw new Error("缺少必填参数: code（需要重构的代码）");
-        }
-        const goalDesc = {
-            improve_readability: "提高可读性",
-            reduce_complexity: "降低复杂度",
-            extract_function: "提取函数",
-            remove_duplication: "消除重复",
-            improve_naming: "改进命名",
-        };
-        const guide = PROMPT_TEMPLATE
-            .replace(/{code}/g, code)
-            .replace(/{goal}/g, goalDesc[goal] || goal);
-        return {
-            content: [{ type: "text", text: guide }],
-        };
-    }
-    catch (error) {
-        const errorMsg = error instanceof Error ? error.message : String(error);
-        return {
-            content: [{ type: "text", text: `❌ 编排执行失败: ${errorMsg}` }],
-            isError: true,
-        };
-    }
-}

package/build/tools/start_release.d.ts

@@ -1,13 +0,0 @@
-export declare function startRelease(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-}>;