mcp-probe-kit 1.15.1 → 2.0.0

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>;

package/build/tools/genchangelog.js

@@ -1,4 +1,5 @@
 import { parseArgs, getString } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
 // genchangelog 工具实现
 export async function genchangelog(args) {
     try {
@@ -29,222 +30,45 @@ ${version || "请提供版本号（如：v1.2.0）"}
 
 ---
 
-## Changelog 生成步骤
-
-### 第一步：获取 Commit 历史
-
-执行以下命令：
-\`\`\`bash
-# 查看 commit 历史
-git log ${from}..${to} --oneline --no-merges
-
-# 查看详细信息
-git log ${from}..${to} --pretty=format:"%h - %s (%an)" --no-merges
-
-# 查看所有 tags
-git tag -l
-
-# 查看贡献者
-git shortlog ${from}..${to} -sn
-\`\`\`
-
-### 第二步：分类 Commits
-
-按类型分组：
-- **✨ Features (feat)**：新功能
-- **🐛 Bug Fixes (fix)**：Bug 修复
-- **📝 Documentation (docs)**：文档变更
-- **💄 Styles (style)**：代码格式
-- **♻️ Refactoring (refactor)**：重构
-- **⚡ Performance (perf)**：性能优化
-- **✅ Tests (test)**：测试相关
-- **🔧 Chores (chore)**：构建/工具变更
-- **💥 BREAKING CHANGES**：破坏性变更
-
-### 第三步：生成 Changelog
-
-**格式标准**：[Keep a Changelog](https://keepachangelog.com/)
-
-\`\`\`markdown
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [版本号] - YYYY-MM-DD
-
-### Added（新增）
-- 新功能 1 (#PR号)
-- 新功能 2 by @contributor
-
-### Changed（变更）
-- 修改的功能 1
-- 修改的功能 2
-
-### Deprecated（废弃）
-- 即将移除的功能
-
-### Removed（移除）
-- 已移除的功能
-
-### Fixed（修复）
-- Bug 修复 1 (#issue号)
-- Bug 修复 2
-
-### Security（安全）
-- 安全漏洞修复
-
-## [上一个版本] - YYYY-MM-DD
-
-...
-\`\`\`
-
----
-
-## Changelog 模板
-
-\`\`\`markdown
-# Changelog
-
-## [${version || "1.2.0"}] - ${new Date().toISOString().split('T')[0]}
-
-### ✨ Added
-- 新增用户认证功能 (#123) [@contributor1]
-- 新增数据导出功能 (#125)
-- 新增邮件通知系统
-
-### 🔄 Changed
-- 优化数据库查询性能 (#130)
-- 更新 UI 设计风格
-- 升级依赖包到最新版本
-
-### 🗑️ Deprecated
-- \`oldAPI()\` 方法即将在 v2.0 中移除，请使用 \`newAPI()\`
-
-### ❌ Removed
-- 移除了废弃的 \`legacyFeature\`
-- 删除了未使用的配置项
-
-### 🐛 Fixed
-- 修复登录页面样式错误 (#128)
-- 修复数据分页显示问题 (#132)
-- 修复内存泄漏问题 (#135)
-
-### 🔒 Security
-- 修复 SQL 注入漏洞 (CVE-2024-XXXX)
-- 更新依赖以修复安全漏洞
-
-### 💥 BREAKING CHANGES
-- API 端点从 \`/api/v1/users\` 改为 \`/api/v2/users\`
-- 配置文件格式从 JSON 改为 YAML
-- 最低 Node.js 版本要求提升到 18.x
-
-### 📚 Documentation
-- 更新 README 文档
-- 添加 API 使用指南
-- 完善贡献指南
-
-### 🏗️ Infrastructure
-- 升级 CI/CD 流程
-- 添加 Docker 支持
-- 配置自动化测试
-
-### 👥 Contributors
-感谢以下贡献者：
-- @contributor1 - 3 commits
-- @contributor2 - 2 commits
-- @contributor3 - 1 commit
-
-**Full Changelog**: https://github.com/owner/repo/compare/v1.1.0...v${version || "1.2.0"}
-\`\`\`
-
----
-
-## Changelog 最佳实践
-
-### 内容要求
-
-1. **明确说明变更**
-   - 用户能理解的语言（避免技术术语）
-   - 说明影响范围
-   - 提供迁移指南（破坏性变更）
-
-2. **链接相关 Issue/PR**
-   - 使用 (#123) 格式
-   - 方便追溯详细信息
-
-3. **归功贡献者**
-   - 使用 @username 格式
-   - 体现团队协作
-
-### 版本规范
-
-**语义化版本 (Semantic Versioning)**：
-- **Major (X.0.0)**：破坏性变更
-- **Minor (x.X.0)**：新功能（向后兼容）
-- **Patch (x.x.X)**：Bug 修复
-
-### 发布流程
-
-1. 更新 CHANGELOG.md
-2. 更新 package.json 版本号
-3. 创建 Git tag：\`git tag -a v1.2.0 -m "Release v1.2.0"\`
-4. 推送 tag：\`git push origin v1.2.0\`
-5. 发布 GitHub Release
-
----
-
-## 自动化工具
-
-**推荐工具**：
-- **standard-version**：自动生成 changelog
-- **conventional-changelog**：基于 commit 生成
-- **semantic-release**：自动发布版本
-
-**使用示例**：
-\`\`\`bash
-# 安装
-npm install -D standard-version
-
-# 生成 changelog
-npx standard-version
-
-# 首次发布
-npx standard-version --first-release
-\`\`\`
-
----
-
----
-
-## ⚠️ 边界约束
-
-- ❌ 仅输出 CHANGELOG 文本，不自动写入文件
-- ❌ 不执行 git 命令
-- ✅ 输出完整的 CHANGELOG Markdown
-
-现在请根据 commit 历史生成详细的 CHANGELOG.md 内容。`;
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: message,
-                },
-            ],
+## Changelog 生成指南
+
+请生成符合 [Keep a Changelog](https://keepachangelog.com/) 规范的 CHANGELOG，包括：
+
+1. **Added（新增）** - 新功能
+2. **Changed（变更）** - 功能修改
+3. **Deprecated（废弃）** - 即将移除的功能
+4. **Removed（移除）** - 已移除的功能
+5. **Fixed（修复）** - Bug 修复
+6. **Security（安全）** - 安全漏洞修复
+
+**重要**: 请使用结构化输出格式返回结果。`;
+        // 创建结构化数据对象
+        const structuredData = {
+            summary: `生成 ${version || "新版本"} 的 Changelog`,
+            version: version || "",
+            date: new Date().toISOString().split('T')[0],
+            content: "", // AI 将填充实际的 Changelog 内容
+            changes: {
+                features: [],
+                fixes: [],
+                breaking: [],
+            },
         };
+        return okStructured(message, structuredData, {
+            schema: (await import("../schemas/output/generation-tools.js")).ChangelogSchema,
+        });
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `❌ 生成 Changelog 失败: ${errorMessage}`,
-                },
-            ],
-            isError: true,
+        const errorData = {
+            summary: "Changelog 生成失败",
+            version: "",
+            date: new Date().toISOString().split('T')[0],
+            content: "",
+            changes: {},
         };
+        return okStructured(`❌ 生成 Changelog 失败: ${errorMessage}`, errorData, {
+            schema: (await import("../schemas/output/generation-tools.js")).ChangelogSchema,
+        });
     }
 }