mcp-probe-kit 1.15.0 → 2.0.0

package/build/tools/debug.js

@@ -1,4 +1,5 @@
 import { parseArgs, getString } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
 // debug 工具实现
 export async function debug(args) {
     try {
@@ -107,25 +108,26 @@ ${context || "请提供相关代码或场景描述"}
 - ✅ 输出结构化调试策略和解决方案
 
 现在请按照上述步骤分析错误并提供具体的调试方案。`;
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: message,
-                },
-            ],
+        // 创建结构化数据
+        const structuredData = {
+            summary: "错误分析完成，请查看详细报告",
+            rootCause: "", // AI 会填充
+            errorType: "unknown", // AI 会填充
+            solutions: [], // AI 会填充
         };
+        return okStructured(message, structuredData, {
+            schema: (await import('../schemas/output/core-tools.js')).DebugReportSchema,
+        });
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `❌ 生成调试策略失败: ${errorMessage}`,
-                },
-            ],
-            isError: true,
-        };
+        return okStructured(`❌ 生成调试策略失败: ${errorMessage}`, {
+            summary: `调试分析失败: ${errorMessage}`,
+            rootCause: errorMessage,
+            errorType: "unknown",
+            solutions: [],
+        }, {
+            schema: (await import('../schemas/output/core-tools.js')).DebugReportSchema,
+        });
     }
 }

package/build/tools/estimate.d.ts

@@ -1,22 +1,4 @@
-/**
- * estimate 工具
- *
- * 功能：评估开发任务的工作量
- * 模式：指令生成器模式 - 返回估算指南，由 AI 执行实际分析
- */
 /**
  * estimate 工具实现
  */
-export declare function estimate(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-}>;
+export declare function estimate(args: any): Promise<import("../lib/response.js").ToolResponse>;

package/build/tools/estimate.js

@@ -1,3 +1,5 @@
+import { parseArgs, getString, getNumber } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
 /**
  * estimate 工具
  *
@@ -218,7 +220,6 @@ const PROMPT_TEMPLATE = `# 工作量估算指南
 *指南版本: 1.0.0*
 *工具: MCP Probe Kit - estimate*
 `;
-import { parseArgs, getString, getNumber } from "../utils/parseArgs.js";
 /**
  * estimate 工具实现
  */
@@ -260,15 +261,44 @@ export async function estimate(args) {
             .replace(/{team_size}/g, String(teamSize))
             .replace(/{experience_level}/g, expLevelMap[experienceLevel] || experienceLevel)
             .replace(/{code_context_section}/g, codeContextSection);
-        return {
-            content: [{ type: "text", text: guide }],
+        // 创建结构化数据对象
+        const structuredData = {
+            summary: `工作量估算：${taskDescription.substring(0, 50)}...`,
+            storyPoints: 0,
+            timeEstimates: {
+                optimistic: "待估算",
+                normal: "待估算",
+                pessimistic: "待估算"
+            },
+            breakdown: [
+                { task: "需求理解", hours: 0, complexity: "low" },
+                { task: "设计", hours: 0, complexity: "medium" },
+                { task: "编码", hours: 0, complexity: "medium" },
+                { task: "测试", hours: 0, complexity: "medium" }
+            ],
+            risks: [],
+            assumptions: [
+                `团队规模：${teamSize} 人`,
+                `经验水平：${expLevelMap[experienceLevel] || experienceLevel}`
+            ]
         };
+        return okStructured(guide, structuredData, {
+            schema: (await import("../schemas/output/project-tools.js")).EstimateSchema,
+        });
     }
     catch (error) {
         const errorMsg = error instanceof Error ? error.message : String(error);
-        return {
-            content: [{ type: "text", text: `❌ 工作量估算失败: ${errorMsg}` }],
-            isError: true,
+        const errorData = {
+            summary: "工作量估算失败",
+            storyPoints: 0,
+            timeEstimates: {
+                optimistic: "未知",
+                normal: "未知",
+                pessimistic: "未知"
+            }
         };
+        return okStructured(`❌ 工作量估算失败: ${errorMsg}`, errorData, {
+            schema: (await import("../schemas/output/project-tools.js")).EstimateSchema,
+        });
     }
 }

package/build/tools/fix_bug.d.ts

@@ -9,16 +9,4 @@
 /**
  * fix_bug 工具实现
  */
-export declare function fixBug(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-}>;
+export declare function fixBug(args: any): Promise<import("../lib/response.js").ToolResponse>;

package/build/tools/fix_bug.js

@@ -295,6 +295,7 @@ describe('[功能描述]', () => {
 *工具: MCP Probe Kit - fix_bug*
 `;
 import { parseArgs, getString } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
 /**
  * fix_bug 工具实现
  */
@@ -347,15 +348,32 @@ export async function fixBug(args) {
             .replace(/{stack_trace_section}/g, stackTraceSection)
             .replace(/{reproduce_section}/g, reproduceSection)
             .replace(/{behavior_section}/g, behaviorSection);
-        return {
-            content: [{ type: "text", text: guide }],
+        // 创建结构化数据
+        const structuredData = {
+            summary: "Bug 修复指南已生成",
+            bugType: "functional", // AI 会填充
+            severity: "medium", // AI 会填充
+            rootCause: "", // AI 会填充
+            fixPlan: {
+                steps: [], // AI 会填充
+            },
+            testPlan: {}, // AI 会填充
         };
+        return okStructured(guide, structuredData, {
+            schema: (await import('../schemas/output/core-tools.js')).BugAnalysisSchema,
+        });
     }
     catch (error) {
         const errorMsg = error instanceof Error ? error.message : String(error);
-        return {
-            content: [{ type: "text", text: `❌ 生成修复指南失败: ${errorMsg}` }],
-            isError: true,
-        };
+        return okStructured(`❌ 生成修复指南失败: ${errorMsg}`, {
+            summary: `生成修复指南失败: ${errorMsg}`,
+            bugType: "functional",
+            severity: "low",
+            rootCause: errorMsg,
+            fixPlan: { steps: [] },
+            testPlan: {},
+        }, {
+            schema: (await import('../schemas/output/core-tools.js')).BugAnalysisSchema,
+        });
     }
 }

package/build/tools/gen_mock.d.ts

@@ -1,22 +1,4 @@
-/**
- * gen_mock 工具
- *
- * 功能：根据数据结构生成 Mock 数据
- * 模式：指令生成器模式 - 返回生成指南，由 AI 执行实际生成
- */
 /**
  * gen_mock 工具实现
  */
-export declare function genMock(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-}>;
+export declare function genMock(args: any): Promise<import("../lib/response.js").ToolResponse>;

package/build/tools/gen_mock.js

@@ -1,208 +1,5 @@
-/**
- * gen_mock 工具
- *
- * 功能：根据数据结构生成 Mock 数据
- * 模式：指令生成器模式 - 返回生成指南，由 AI 执行实际生成
- */
-const PROMPT_TEMPLATE = `# Mock 数据生成指南
-
-## 🎯 生成目标
-
-**数据结构**:
-\`\`\`
-{schema}
-\`\`\`
-
-**生成配置**:
-- 数量: {count} 条
-- 格式: {format}
-- 语言: {locale}
-{seed_section}
-
----
-
-## 📋 生成步骤
-
-### 步骤 1: 解析数据结构
-
-分析输入的数据结构，识别：
-1. 字段名称和类型
-2. 必填/可选字段（?标记）
-3. 嵌套结构
-4. 数组类型
-
-### 步骤 2: 字段语义识别
-
-根据字段名自动匹配语义，生成符合语义的数据：
-
-| 字段名模式 | 生成规则 | 中文示例 | 英文示例 |
-|------------|----------|----------|----------|
-| id, _id | UUID/自增ID | uuid-xxx | uuid-xxx |
-| name, 姓名 | 人名 | 张三、李四 | John Doe |
-| email, 邮箱 | 邮箱格式 | zhangsan@example.com | john@example.com |
-| phone, mobile, 手机 | 手机号 | 138xxxx1234 | +1-xxx-xxx-xxxx |
-| avatar, 头像 | 图片URL | https://api.dicebear.com/... | |
-| address, 地址 | 地址 | 北京市朝阳区xxx | 123 Main St |
-| city, 城市 | 城市名 | 北京、上海 | New York |
-| country, 国家 | 国家名 | 中国 | United States |
-| date, 日期 | 日期 | 2024-01-15 | 2024-01-15 |
-| createdAt, created_at | 过去时间 | 2024-01-01T10:00:00Z | |
-| updatedAt, updated_at | 最近时间 | 2024-01-15T15:30:00Z | |
-| title, 标题 | 短句 | 这是一个标题 | A Sample Title |
-| description, desc, 描述 | 段落 | 这是描述内容... | Lorem ipsum... |
-| content, 内容 | 长文本 | 文章内容... | Article content... |
-| price, 价格 | 金额 | 99.00 | 99.00 |
-| amount, 数量 | 整数 | 10 | 10 |
-| status, 状态 | 枚举 | active/inactive | active/inactive |
-| type, 类型 | 枚举 | 根据上下文 | |
-| url, 链接 | URL | https://example.com | |
-| image, 图片 | 图片URL | https://picsum.photos/... | |
-| age, 年龄 | 18-60 | 25 | 25 |
-| gender, 性别 | 性别 | 男/女 | male/female |
-| username, 用户名 | 用户名 | user_123 | user_123 |
-| password, 密码 | 密码占位 | ******** | ******** |
-| token | Token | tok_xxx | tok_xxx |
-| code, 编码 | 编码 | CODE001 | CODE001 |
-| sort, order, 排序 | 序号 | 1, 2, 3 | 1, 2, 3 |
-| enabled, active | 布尔 | true/false | true/false |
-| tags, 标签 | 标签数组 | ["标签1", "标签2"] | ["tag1", "tag2"] |
-
-### 步骤 3: 类型映射
-
-基础类型的默认生成规则：
-
-| 类型 | 生成规则 |
-|------|----------|
-| string | 根据字段名语义，或随机字符串 |
-| number | 1-100 的随机整数 |
-| boolean | true/false 随机 |
-| Date | 最近30天内的随机时间 |
-| string[] | 3-5个随机字符串 |
-| number[] | 3-5个随机数字 |
-| enum | 从枚举值中随机选择 |
-| union | 从联合类型中随机选择 |
-
-### 步骤 4: 生成数据
-
-根据识别结果生成 {count} 条数据。
-
-**注意事项**:
-- 确保数据多样性，避免重复
-- 数值类型保持合理范围
-- 日期类型保持合理顺序（createdAt < updatedAt）
-- 关联字段保持一致性
-
----
-
-## 📊 输出格式
-
-### JSON 格式
-\`\`\`json
-[
-  {
-    "field1": "value1",
-    "field2": 123
-  }
-]
-\`\`\`
-
-### TypeScript 格式
-\`\`\`typescript
-const mockData: YourType[] = [
-  {
-    field1: "value1",
-    field2: 123
-  }
-];
-
-export default mockData;
-\`\`\`
-
-### JavaScript 格式
-\`\`\`javascript
-const mockData = [
-  {
-    field1: "value1",
-    field2: 123
-  }
-];
-
-module.exports = mockData;
-\`\`\`
-
-### CSV 格式（仅扁平数据）
-\`\`\`csv
-field1,field2
-value1,123
-\`\`\`
-
----
-
-## 🔧 高级功能
-
-### 自定义规则
-
-在 schema 注释中指定规则：
-
-\`\`\`typescript
-interface User {
-  id: string;           // UUID
-  age: number;          // range: 18-60
-  status: string;       // enum: active, inactive, pending
-  score: number;        // range: 0-100, decimal: 2
-  tags: string[];       // count: 3-5
-  level: number;        // enum: 1, 2, 3
-}
-\`\`\`
-
-### 关联数据
-
-生成有关联关系的数据：
-
-\`\`\`json
-// 先生成 users
-[
-  { "id": "user-1", "name": "张三" },
-  { "id": "user-2", "name": "李四" }
-]
-
-// 再生成 orders，引用 user_id
-[
-  { "id": "order-1", "user_id": "user-1", "amount": 100 },
-  { "id": "order-2", "user_id": "user-2", "amount": 200 }
-]
-\`\`\`
-
-### 固定值
-
-某些字段使用固定值：
-
-\`\`\`typescript
-interface Config {
-  version: string;      // fixed: "1.0.0"
-  env: string;          // fixed: "development"
-}
-\`\`\`
-
----
-
-## ✅ 生成检查清单
-
-- [ ] 数据结构已正确解析
-- [ ] 字段语义已识别
-- [ ] 数据类型正确
-- [ ] 数量符合要求: {count} 条
-- [ ] 格式正确: {format}
-- [ ] 语言符合设置: {locale}
-- [ ] 数据具有多样性
-- [ ] 关联数据一致（如有）
-
----
-
-*指南版本: 1.0.0*
-*工具: MCP Probe Kit - gen_mock*
-`;
 import { parseArgs, getString, getNumber } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
 /**
  * gen_mock 工具实现
  */
@@ -237,33 +34,51 @@ export async function genMock(args) {
         if (count < 1 || count > 1000) {
             throw new Error("count 参数必须在 1-1000 之间");
         }
-        const formatMap = {
-            json: "JSON",
-            typescript: "TypeScript",
-            javascript: "JavaScript",
-            csv: "CSV",
-        };
-        const localeMap = {
-            "zh-CN": "中文（简体）",
-            "en-US": "英文（美国）",
-            "ja-JP": "日文",
-        };
-        const seedSection = seed ? `- 随机种子: ${seed}（可重复生成）` : "";
-        const guide = PROMPT_TEMPLATE
-            .replace(/{schema}/g, schema)
-            .replace(/{count}/g, String(count))
-            .replace(/{format}/g, formatMap[format] || format)
-            .replace(/{locale}/g, localeMap[locale] || locale)
-            .replace(/{seed_section}/g, seedSection);
-        return {
-            content: [{ type: "text", text: guide }],
+        const message = `请生成 Mock 数据：
+
+📝 **数据结构**：
+\`\`\`
+${schema}
+\`\`\`
+
+📋 **生成配置**：
+- 数量: ${count} 条
+- 格式: ${format}
+- 语言: ${locale}
+${seed ? `- 随机种子: ${seed}（可重复生成）` : ""}
+
+---
+
+## Mock 数据生成指南
+
+请根据数据结构生成 ${count} 条 Mock 数据，注意：
+1. 根据字段名识别语义（如 email、phone、name 等）
+2. 生成符合语义的真实数据
+3. 确保数据多样性
+4. 保持关联数据一致性
+
+**重要**: 请使用结构化输出格式返回结果。`;
+        // 创建结构化数据对象
+        const structuredData = {
+            summary: `生成 ${count} 条 ${format} 格式的 Mock 数据`,
+            format: format,
+            count: count,
+            data: [], // AI 将填充实际的 Mock 数据
         };
+        return okStructured(message, structuredData, {
+            schema: (await import("../schemas/output/generation-tools.js")).MockDataSchema,
+        });
     }
     catch (error) {
         const errorMsg = error instanceof Error ? error.message : String(error);
-        return {
-            content: [{ type: "text", text: `❌ Mock 数据生成失败: ${errorMsg}` }],
-            isError: true,
+        const errorData = {
+            summary: "Mock 数据生成失败",
+            format: "json",
+            count: 0,
+            data: [],
         };
+        return okStructured(`❌ Mock 数据生成失败: ${errorMsg}`, errorData, {
+            schema: (await import("../schemas/output/generation-tools.js")).MockDataSchema,
+        });
     }
 }

package/build/tools/genapi.d.ts

@@ -1,13 +1 @@
-export declare function genapi(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-}>;
+export declare function genapi(args: any): Promise<import("../lib/response.js").ToolResponse>;

package/build/tools/genapi.js

@@ -1,4 +1,5 @@
 import { parseArgs, getString } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
 // genapi 工具实现
 export async function genapi(args) {
     try {
@@ -150,25 +151,27 @@ paths:
 - ✅ 输出完整的 API 文档
 
 现在请根据上述代码生成完整的 API 文档。`;
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: message,
-                },
-            ],
+        // 创建结构化数据对象
+        const apiDoc = {
+            summary: `生成 ${format} 格式的 API 文档`,
+            format: format,
+            endpoints: [],
+            documentation: message,
         };
+        return okStructured(message, apiDoc, {
+            schema: (await import("../schemas/output/generation-tools.js")).APIDocumentationSchema,
+        });
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `❌ 生成 API 文档失败: ${errorMessage}`,
-                },
-            ],
-            isError: true,
+        const errorData = {
+            summary: `生成 API 文档失败: ${errorMessage}`,
+            format: 'markdown',
+            endpoints: [],
+            documentation: '',
         };
+        return okStructured(`❌ 生成 API 文档失败: ${errorMessage}`, errorData, {
+            schema: (await import("../schemas/output/generation-tools.js")).APIDocumentationSchema,
+        });
     }
 }

package/build/tools/genchangelog.d.ts

@@ -1,13 +1 @@
-export declare function genchangelog(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-}>;
+export declare function genchangelog(args: any): Promise<import("../lib/response.js").ToolResponse>;