mcp-probe-kit 3.0.3 → 3.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,60 +1,75 @@
1
- # MCP Probe Kit
1
+ <div align="center">
2
+ <img src="docs/assets/logo.png" alt="知时MCP Logo" width="160"/>
3
+ <h1>知时MCP | mcp-probe-kit</h1>
4
+ <p><strong>Know the Context, Feed the Moment.</strong></p>
5
+ <p>
6
+ <code>Introspection</code> · <code>Context Hydration</code> · <code>Delegated Orchestration</code>
7
+ </p>
8
+ </div>
9
+
10
+ ---
11
+
12
+ > **Talk is cheap, show me the Context.**
13
+ >
14
+ > mcp-probe-kit is a protocol-level toolkit designed for developers who want AI to truly understand their project's intent. It's not just a collection of 21 tools—it's a context-aware system that helps AI agents grasp what you're building.
15
+
16
+ **Languages**: [English](README.md) | [简体中文](i18n/README.zh-CN.md) | [日本語](i18n/README.ja-JP.md) | [한국어](i18n/README.ko-KR.md) | [Español](i18n/README.es-ES.md) | [Français](i18n/README.fr-FR.md) | [Deutsch](i18n/README.de-DE.md) | [Português (BR)](i18n/README.pt-BR.md)
2
17
 
3
18
  [![npm version](https://img.shields.io/npm/v/mcp-probe-kit.svg)](https://www.npmjs.com/package/mcp-probe-kit)
4
19
  [![npm downloads](https://img.shields.io/npm/dm/mcp-probe-kit.svg)](https://www.npmjs.com/package/mcp-probe-kit)
5
20
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6
21
  [![GitHub stars](https://img.shields.io/github/stars/mybolide/mcp-probe-kit.svg)](https://github.com/mybolide/mcp-probe-kit/stargazers)
7
22
 
8
- > 🚀 AI 驱动的完整研发工具集 - 覆盖开发全流程
23
+ > 🚀 AI-Powered Complete Development Toolkit - Covering the Entire Development Lifecycle
9
24
 
10
- 一个强大的 MCP (Model Context Protocol) 服务器,提供 **21 个工具**,覆盖从产品分析到最终发布的全流程(需求设计开发质量发布),所有工具支持**结构化输出**。
25
+ A powerful MCP (Model Context Protocol) server providing **21 tools** covering the complete workflow from product analysis to final release (Requirements DesignDevelopmentQualityRelease), all tools support **structured output**.
11
26
 
12
- **🎉 v3.0 重大更新**:精简工具数量,专注核心竞争力,消除选择困难,让 AI 做更多原生工作
27
+ **🎉 v3.0 Major Update**: Streamlined tool count, focus on core competencies, eliminate choice paralysis, let AI do more native work
13
28
 
14
- **支持所有 MCP 客户端**:CursorClaude DesktopClineContinue
29
+ **Supports All MCP Clients**: Cursor, Claude Desktop, Cline, Continue, and more
15
30
 
16
- **协议版本**:MCP 2025-11-25 · **SDK**:@modelcontextprotocol/sdk 1.25.3
31
+ **Protocol Version**: MCP 2025-11-25 · **SDK**: @modelcontextprotocol/sdk 1.25.3
17
32
 
18
33
  ---
19
34
 
20
- ## 📚 完整文档
35
+ ## 📚 Complete Documentation
21
36
 
22
37
  **👉 [https://mcp-probe-kit.bytezonex.com](https://mcp-probe-kit.bytezonex.com/)**
23
38
 
24
- - [快速开始](https://mcp-probe-kit.bytezonex.com/pages/getting-started.html) - 5分钟完成安装配置
25
- - [所有工具](https://mcp-probe-kit.bytezonex.com/pages/all-tools.html) - 20个工具完整列表
26
- - [最佳实践](https://mcp-probe-kit.bytezonex.com/pages/examples.html) - 完整研发流程实战指南
27
- - [v3.0 迁移指南](https://mcp-probe-kit.bytezonex.com/pages/migration.html) - v2.x v3.0 升级指南
39
+ - [Quick Start](https://mcp-probe-kit.bytezonex.com/pages/getting-started.html) - Setup in 5 minutes
40
+ - [All Tools](https://mcp-probe-kit.bytezonex.com/pages/all-tools.html) - Complete list of 21 tools
41
+ - [Best Practices](https://mcp-probe-kit.bytezonex.com/pages/examples.html) - Full development workflow guide
42
+ - [v3.0 Migration Guide](https://mcp-probe-kit.bytezonex.com/pages/migration.html) - Upgrade from v2.x to v3.0
28
43
 
29
44
  ---
30
45
 
31
- ## ✨ 核心特性
46
+ ## ✨ Core Features
32
47
 
33
- ### 📦 21 个工具
48
+ ### 📦 21 Tools
34
49
 
35
- - **🔄 工作流编排** (6) - 一键完成复杂开发流程
50
+ - **🔄 Workflow Orchestration** (6 tools) - One-click complex development workflows
36
51
  - `start_feature`, `start_bugfix`, `start_onboard`, `start_ui`, `start_product`, `start_ralph`
37
- - **🔍 代码分析** (3) - 代码质量与重构
52
+ - **🔍 Code Analysis** (3 tools) - Code quality and refactoring
38
53
  - `code_review`, `fix_bug`, `refactor`
39
- - **📝 Git 工具** (2) - Git 提交和工作报告
54
+ - **📝 Git Tools** (2 tools) - Git commits and work reports
40
55
  - `gencommit`, `git_work_report`
41
- - **⚡ 代码生成** (1) - 测试生成
56
+ - **⚡ Code Generation** (1 tool) - Test generation
42
57
  - `gentest`
43
- - **📦 项目管理** (7) - 项目初始化与需求管理
58
+ - **📦 Project Management** (7 tools) - Project initialization and requirements management
44
59
  - `init_project`, `init_project_context`, `add_feature`, `estimate`, `interview`, `ask_user`
45
- - **🎨 UI/UX 工具** (3) - 设计系统与数据同步
60
+ - **🎨 UI/UX Tools** (3 tools) - Design systems and data synchronization
46
61
  - `ui_design_system`, `ui_search`, `sync_ui_data`
47
62
 
48
- ### 🎯 结构化输出
63
+ ### 🎯 Structured Output
49
64
 
50
- 核心与编排工具支持**结构化输出**,返回机器可读的 JSON 数据,提高 AI 解析准确性,支持工具串联和状态追踪。
65
+ Core and orchestration tools support **structured output**, returning machine-readable JSON data, improving AI parsing accuracy, supporting tool chaining and state tracking.
51
66
 
52
- ### 🧭 委托式编排协议(Delegated Plan)
67
+ ### 🧭 Delegated Orchestration Protocol
53
68
 
54
- 所有 `start_*` 编排工具会在 `structuredContent.metadata.plan` 中返回**执行计划**。
55
- AI 需要**按步骤调用工具并落盘文件**,而不是由工具内部直接执行。
69
+ All `start_*` orchestration tools return an **execution plan** in `structuredContent.metadata.plan`.
70
+ AI needs to **call tools step by step and persist files**, rather than the tool executing internally.
56
71
 
57
- **Plan Schema(核心字段)**:
72
+ **Plan Schema (Core Fields)**:
58
73
  ```json
59
74
  {
60
75
  "mode": "delegated",
@@ -62,177 +77,177 @@ AI 需要**按步骤调用工具并落盘文件**,而不是由工具内部直
62
77
  {
63
78
  "id": "spec",
64
79
  "tool": "add_feature",
65
- "args": { "feature_name": "user-auth", "description": "用户认证功能" },
80
+ "args": { "feature_name": "user-auth", "description": "User authentication feature" },
66
81
  "outputs": ["docs/specs/user-auth/requirements.md"]
67
82
  }
68
83
  ]
69
84
  }
70
85
  ```
71
86
 
72
- **字段说明**:
73
- - `mode`: 固定为 `delegated`
74
- - `steps`: 执行步骤数组
75
- - `tool`: 工具名称(如 `add_feature`)
76
- - `action`: 无工具时的手动动作描述(如 `update_project_context`)
77
- - `args`: 工具参数
78
- - `outputs`: 预期产物
79
- - `when/dependsOn/note`: 可选的条件与说明
87
+ **Field Description**:
88
+ - `mode`: Fixed as `delegated`
89
+ - `steps`: Array of execution steps
90
+ - `tool`: Tool name (e.g. `add_feature`)
91
+ - `action`: Manual action description when no tool (e.g. `update_project_context`)
92
+ - `args`: Tool parameters
93
+ - `outputs`: Expected artifacts
94
+ - `when/dependsOn/note`: Optional conditions and notes
80
95
 
81
- ### 🧩 结构化输出字段规范(关键字段)
96
+ ### 🧩 Structured Output Field Specification (Key Fields)
82
97
 
83
- 编排与原子工具都会返回 `structuredContent`,常用字段约定如下:
84
- - `summary`: 一句话摘要
85
- - `status`: 状态(pending/success/failed/partial
86
- - `steps`: 执行步骤(编排工具)
87
- - `artifacts`: 产物列表(路径 + 用途)
88
- - `metadata.plan`: 委托式执行计划(仅 start_*)
89
- - `specArtifacts`: 规格文档产物(start_feature
90
- - `estimate`: 估算结果(start_feature / estimate
98
+ Both orchestration and atomic tools return `structuredContent`, common fields:
99
+ - `summary`: One-line summary
100
+ - `status`: Status (pending/success/failed/partial)
101
+ - `steps`: Execution steps (orchestration tools)
102
+ - `artifacts`: Artifact list (path + purpose)
103
+ - `metadata.plan`: Delegated execution plan (only start_*)
104
+ - `specArtifacts`: Specification artifacts (start_feature)
105
+ - `estimate`: Estimation results (start_feature / estimate)
91
106
 
92
- ### 🧠 需求澄清模式(Requirements Loop
107
+ ### 🧠 Requirements Clarification Mode (Requirements Loop)
93
108
 
94
- 当需求不够清晰时,可在 `start_feature / start_bugfix / start_ui` 中使用 `requirements_mode=loop`。
95
- 该模式会先进行 1-2 轮结构化澄清,再进入规格/修复/UI 执行流程。
109
+ When requirements are unclear, use `requirements_mode=loop` in `start_feature / start_bugfix / start_ui`.
110
+ This mode performs 1-2 rounds of structured clarification before entering spec/fix/UI execution.
96
111
 
97
- **示例:**
112
+ **Example:**
98
113
  ```json
99
114
  {
100
115
  "feature_name": "user-auth",
101
- "description": "用户认证功能",
116
+ "description": "User authentication feature",
102
117
  "requirements_mode": "loop",
103
118
  "loop_max_rounds": 2,
104
119
  "loop_question_budget": 5
105
120
  }
106
121
  ```
107
122
 
108
- ### 🧩 模板系统(普通模型友好)
123
+ ### 🧩 Template System (Regular Model Friendly)
109
124
 
110
- `add_feature` 支持模板档位,默认 `auto` 自动选择:需求不完整时偏向 `guided`(包含更详细的填写规则与检查清单),需求较完整时选择 `strict`(结构更紧凑,适合高能力模型或归档场景)。
125
+ `add_feature` supports template profiles, default `auto` auto-selects: prefers `guided` when requirements are incomplete (includes detailed filling rules and checklists), selects `strict` when requirements are complete (more compact structure, suitable for high-capability models or archival scenarios).
111
126
 
112
- **示例:**
127
+ **Example:**
113
128
  ```json
114
129
  {
115
- "description": "添加用户认证功能",
130
+ "description": "Add user authentication feature",
116
131
  "template_profile": "auto"
117
132
  }
118
133
  ```
119
134
 
120
- **适用工具**:
121
- - `start_feature` 会透传 `template_profile` `add_feature`
122
- - `start_bugfix` / `start_ui` 也支持 `template_profile`,用于控制指导强度(auto/guided/strict
135
+ **Applicable Tools**:
136
+ - `start_feature` passes `template_profile` to `add_feature`
137
+ - `start_bugfix` / `start_ui` also support `template_profile` for controlling guidance strength (auto/guided/strict)
123
138
 
124
- **模板档位策略**:
125
- - `guided`:需求信息少/不完整、普通模型优先
126
- - `strict`:需求已结构化、希望指引更紧凑
127
- - `auto`:默认推荐,自动选择 guided/strict
139
+ **Template Profile Strategy**:
140
+ - `guided`: Less/incomplete requirements info, regular model priority
141
+ - `strict`: Requirements structured, prefer more compact guidance
142
+ - `auto`: Default recommendation, auto-selects guided/strict
128
143
 
129
- ### 🔄 工作流编排
144
+ ### 🔄 Workflow Orchestration
130
145
 
131
- 6 个智能编排工具,自动组合多个基础工具,一键完成复杂开发流程:
132
- - `start_feature` - 新功能开发(需求设计估算)
133
- - `start_bugfix` - Bug 修复(分析修复测试)
134
- - `start_onboard` - 项目上手(生成项目上下文文档)
135
- - `start_ui` - UI 开发(设计系统组件代码)
136
- - `start_product` - 产品设计(PRD → 原型设计系统 → HTML
137
- - `start_ralph` - Ralph Loop(循环开发直到目标完成)
146
+ 6 intelligent orchestration tools that automatically combine multiple basic tools for one-click complex development workflows:
147
+ - `start_feature` - New feature development (Requirements DesignEstimation)
148
+ - `start_bugfix` - Bug fixing (Analysis FixTesting)
149
+ - `start_onboard` - Project onboarding (Generate project context docs)
150
+ - `start_ui` - UI development (Design system ComponentsCode)
151
+ - `start_product` - Product design (PRD → PrototypeDesign system → HTML)
152
+ - `start_ralph` - Ralph Loop (Iterative development until goal completion)
138
153
 
139
- ### 🚀 产品设计工作流
154
+ ### 🚀 Product Design Workflow
140
155
 
141
- `start_product` 是一个完整的产品设计编排工具,从需求到可交互原型:
156
+ `start_product` is a complete product design orchestration tool, from requirements to interactive prototype:
142
157
 
143
- **工作流程:**
144
- 1. **需求分析** - 生成标准 PRD 文档(产品概述、功能需求、页面清单)
145
- 2. **原型设计** - 为每个页面生成详细的原型文档
146
- 3. **设计系统** - 基于产品类型生成设计规范
147
- 4. **HTML 原型** - 生成可直接在浏览器中查看的交互原型
148
- 5. **项目上下文** - 自动更新项目文档
158
+ **Workflow:**
159
+ 1. **Requirements Analysis** - Generate standard PRD (product overview, feature requirements, page list)
160
+ 2. **Prototype Design** - Generate detailed prototype docs for each page
161
+ 3. **Design System** - Generate design specifications based on product type
162
+ 4. **HTML Prototype** - Generate interactive prototype viewable in browser
163
+ 5. **Project Context** - Auto-update project documentation
149
164
 
150
- **结构化输出补充**:
151
- - `start_product.structuredContent.artifacts`:产出物列表(PRD、原型、设计系统等)
152
- - `interview.structuredContent.mode`:`usage` / `questions` / `record`
165
+ **Structured Output Additions**:
166
+ - `start_product.structuredContent.artifacts`: Artifact list (PRD, prototypes, design system, etc.)
167
+ - `interview.structuredContent.mode`: `usage` / `questions` / `record`
153
168
 
154
169
  ### 🎨 UI/UX Pro Max
155
170
 
156
- 3 UI/UX 工具,`start_ui` 作为统一入口:
157
- - `start_ui` - 一键 UI 开发(支持智能模式)(编排工具)
158
- - `ui_design_system` - 智能设计系统生成
159
- - `ui_search` - UI/UX 数据搜索(BM25 算法)
160
- - `sync_ui_data` - 同步最新 UI/UX 数据到本地
171
+ 3 UI/UX tools with `start_ui` as the unified entry point:
172
+ - `start_ui` - One-click UI development (supports intelligent mode) (orchestration tool)
173
+ - `ui_design_system` - Intelligent design system generation
174
+ - `ui_search` - UI/UX data search (BM25 algorithm)
175
+ - `sync_ui_data` - Sync latest UI/UX data locally
161
176
 
162
- **注意**:`start_ui` 会自动调用 `ui_design_system` `ui_search`,您无需单独调用它们。
177
+ **Note**: `start_ui` automatically calls `ui_design_system` and `ui_search`, you don't need to call them separately.
163
178
 
164
- **灵感来源:**
165
- - [ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) - UI/UX 设计系统理念
166
- - [json-render](https://github.com/vercel-labs/json-render) - JSON 模板渲染引擎
179
+ **Inspiration:**
180
+ - [ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) - UI/UX design system philosophy
181
+ - [json-render](https://github.com/vercel-labs/json-render) - JSON template rendering engine
167
182
 
168
- **为什么使用 `sync_ui_data`?**
183
+ **Why use `sync_ui_data`?**
169
184
 
170
- 我们的 `start_ui` 工具依赖丰富的 UI/UX 数据库(颜色、图标、图表、组件、设计模式等)来生成高质量的设计系统和代码。这些数据来自 npm [uipro-cli](https://www.npmjs.com/package/uipro-cli),包含:
171
- - 🎨 颜色方案(主流品牌色、配色方案)
172
- - 🔣 图标库(React IconsHeroicons 等)
173
- - 📊 图表组件(RechartsChart.js 等)
174
- - 🎯 落地页模板(SaaS、电商、政府等)
175
- - 📐 设计规范(间距、字体、阴影等)
185
+ Our `start_ui` tool relies on a rich UI/UX database (colors, icons, charts, components, design patterns, etc.) to generate high-quality design systems and code. This data comes from npm package [uipro-cli](https://www.npmjs.com/package/uipro-cli), including:
186
+ - 🎨 Color schemes (mainstream brand colors, color palettes)
187
+ - 🔣 Icon libraries (React Icons, Heroicons, etc.)
188
+ - 📊 Chart components (Recharts, Chart.js, etc.)
189
+ - 🎯 Landing page templates (SaaS, e-commerce, government, etc.)
190
+ - 📐 Design specifications (spacing, fonts, shadows, etc.)
176
191
 
177
- **数据同步策略:**
178
- 1. **内嵌数据**:构建时同步,离线可用
179
- 2. **缓存数据**:运行时更新到 `~/.mcp-probe-kit/ui-ux-data/`
180
- 3. **手动同步**:使用 `sync_ui_data` 强制更新最新数据
192
+ **Data Sync Strategy:**
193
+ 1. **Embedded Data**: Synced at build time, works offline
194
+ 2. **Cached Data**: Runtime updates to `~/.mcp-probe-kit/ui-ux-data/`
195
+ 3. **Manual Sync**: Use `sync_ui_data` to force update latest data
181
196
 
182
- 这确保了即使在离线环境下,`start_ui` 也能生成专业级的 UI 代码。
197
+ This ensures `start_ui` can generate professional-grade UI code even offline.
183
198
 
184
- ### 🎤 需求访谈
199
+ ### 🎤 Requirements Interview
185
200
 
186
- 2 个访谈工具,在开发前澄清需求:
187
- - `interview` - 结构化需求访谈
188
- - `ask_user` - AI 主动提问
201
+ 2 interview tools to clarify requirements before development:
202
+ - `interview` - Structured requirements interview
203
+ - `ask_user` - AI proactive questioning
189
204
 
190
205
  ---
191
206
 
192
- ## 🧭 工具选择指南
207
+ ## 🧭 Tool Selection Guide
193
208
 
194
- ### 何时使用编排工具 vs 单独工具?
209
+ ### When to use orchestration tools vs individual tools?
195
210
 
196
- **使用编排工具(start_*)当:**
197
- - ✅ 需要完整的工作流程(多个步骤)
198
- - ✅ 希望自动化执行多个任务
199
- - ✅ 需要生成多个产物(文档、代码、测试等)
211
+ **Use orchestration tools (start_*) when:**
212
+ - ✅ Need complete workflow (multiple steps)
213
+ - ✅ Want to automate multiple tasks
214
+ - ✅ Need to generate multiple artifacts (docs, code, tests, etc.)
200
215
 
201
- **使用单独工具当:**
202
- - ✅ 只需要某个特定功能
203
- - ✅ 已经有了项目上下文文档
204
- - ✅ 需要更精细的控制
216
+ **Use individual tools when:**
217
+ - ✅ Only need specific functionality
218
+ - ✅ Already have project context docs
219
+ - ✅ Need more fine-grained control
205
220
 
206
- ### 常见场景选择
221
+ ### Common Scenario Selection
207
222
 
208
- | 场景 | 推荐工具 | 原因 |
209
- |------|---------|------|
210
- | 开发新功能(完整流程) | `start_feature` | 自动完成:规格→估算 |
211
- | 只需要功能规格文档 | `add_feature` | 更轻量,只生成文档 |
212
- | 修复 Bug(完整流程) | `start_bugfix` | 自动完成:分析→修复→测试 |
213
- | 只需要 Bug 分析 | `fix_bug` | 更快速,只分析问题 |
214
- | 生成设计系统 | `ui_design_system` | 直接生成设计规范 |
215
- | 开发 UI 组件 | `start_ui` | 完整流程:设计→组件→代码 |
216
- | 产品设计(从需求到原型) | `start_product` | 一键完成:PRD→原型→HTML |
217
- | 一句话需求分析 | `init_project` | 生成完整项目规格文档 |
218
- | 项目上手文档 | `init_project_context` | 生成技术栈/架构/规范 |
223
+ | Scenario | Recommended Tool | Reason |
224
+ |---------|-----------------|--------|
225
+ | Develop new feature (complete flow) | `start_feature` | Auto-complete: spec→estimation |
226
+ | Only need feature spec docs | `add_feature` | More lightweight, only generates docs |
227
+ | Fix bug (complete flow) | `start_bugfix` | Auto-complete: analysis→fix→test |
228
+ | Only need bug analysis | `fix_bug` | Faster, only analyzes problem |
229
+ | Generate design system | `ui_design_system` | Directly generate design specs |
230
+ | Develop UI components | `start_ui` | Complete flow: design→components→code |
231
+ | Product design (requirements to prototype) | `start_product` | One-click: PRD→prototype→HTML |
232
+ | One-sentence requirement analysis | `init_project` | Generate complete project spec docs |
233
+ | Project onboarding docs | `init_project_context` | Generate tech stack/architecture/conventions |
219
234
 
220
235
  ---
221
236
 
222
- ## 🚀 快速开始
237
+ ## 🚀 Quick Start
223
238
 
224
- ### 方式一:npx 直接使用(推荐)
239
+ ### Method 1: Use directly with npx (Recommended)
225
240
 
226
- 无需安装,直接使用最新版本。
241
+ No installation needed, use the latest version directly.
227
242
 
228
- #### Cursor / Cline 配置
243
+ #### Cursor / Cline Configuration
229
244
 
230
- **配置文件位置:**
245
+ **Config file location:**
231
246
  - Windows: `%APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
232
247
  - macOS: `~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
233
248
  - Linux: `~/.config/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
234
249
 
235
- **配置内容:**
250
+ **Config content:**
236
251
  ```json
237
252
  {
238
253
  "mcpServers": {
@@ -244,14 +259,14 @@ AI 需要**按步骤调用工具并落盘文件**,而不是由工具内部直
244
259
  }
245
260
  ```
246
261
 
247
- #### Claude Desktop 配置
262
+ #### Claude Desktop Configuration
248
263
 
249
- **配置文件位置:**
264
+ **Config file location:**
250
265
  - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
251
266
  - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
252
267
  - Linux: `~/.config/Claude/claude_desktop_config.json`
253
268
 
254
- **配置内容:**
269
+ **Config content:**
255
270
  ```json
256
271
  {
257
272
  "mcpServers": {
@@ -263,13 +278,13 @@ AI 需要**按步骤调用工具并落盘文件**,而不是由工具内部直
263
278
  }
264
279
  ```
265
280
 
266
- ### 方式二:全局安装
281
+ ### Method 2: Global Installation
267
282
 
268
283
  ```bash
269
284
  npm install -g mcp-probe-kit
270
285
  ```
271
286
 
272
- 配置文件中使用:
287
+ Use in config file:
273
288
  ```json
274
289
  {
275
290
  "mcpServers": {
@@ -280,80 +295,81 @@ npm install -g mcp-probe-kit
280
295
  }
281
296
  ```
282
297
 
283
- ### 重启客户端
298
+ ### Restart Client
284
299
 
285
- 配置完成后,**完全退出并重新打开**你的 MCP 客户端。
300
+ After configuration, **completely quit and reopen** your MCP client.
286
301
 
287
- **👉 [详细安装指南](https://mcp-probe-kit.bytezonex.com/pages/getting-started.html)**
302
+ **👉 [Detailed Installation Guide](https://mcp-probe-kit.bytezonex.com/pages/getting-started.html)**
288
303
 
289
304
  ---
290
305
 
291
- ## 💡 使用示例
306
+ ## 💡 Usage Examples
292
307
 
293
- ### 日常开发
308
+ ### Daily Development
294
309
  ```bash
295
- code_review @feature.ts # 代码审查
296
- gentest @feature.ts # 生成测试
297
- gencommit # 生成提交消息
310
+ code_review @feature.ts # Code review
311
+ gentest @feature.ts # Generate tests
312
+ gencommit # Generate commit message
298
313
  ```
299
314
 
300
- ### 新功能开发
315
+ ### New Feature Development
301
316
  ```bash
302
- start_feature user-auth "用户认证功能"
303
- # 自动完成:需求分析设计方案工作量估算
317
+ start_feature user-auth "User authentication feature"
318
+ # Auto-complete: Requirements analysis DesignEffort estimation
304
319
  ```
305
320
 
306
- ### Bug 修复
321
+ ### Bug Fixing
307
322
  ```bash
308
323
  start_bugfix
309
- # 然后粘贴错误信息
310
- # 自动完成:问题定位修复方案测试代码
324
+ # Then paste error message
325
+ # Auto-complete: Problem location Fix solution Test code
311
326
  ```
312
327
 
313
- ### 产品设计
328
+ ### Product Design
314
329
  ```bash
315
- start_product "在线教育平台" --product_type=SaaS
316
- # 自动完成:PRD → 原型设计设计系统 → HTML 原型
330
+ start_product "Online Education Platform" --product_type=SaaS
331
+ # Auto-complete: PRD → PrototypeDesign system → HTML prototype
317
332
  ```
318
333
 
319
- ### UI 开发
334
+ ### UI Development
320
335
  ```bash
321
- start_ui "登录页面" --mode=auto
322
- # 自动完成:设计系统组件生成代码输出
336
+ start_ui "Login Page" --mode=auto
337
+ # Auto-complete: Design system Component generation Code output
323
338
  ```
324
339
 
325
- ### 项目上下文文档
340
+ ### Project Context Documentation
326
341
  ```bash
327
- # 单文件模式(默认)- 生成一个完整的 project-context.md
342
+ # Single file mode (default) - Generate a complete project-context.md
328
343
  init_project_context
329
344
 
330
- # 模块化模式 - 生成 6 个分类文档(适合大型项目)
345
+ # Modular mode - Generate 6 category docs (suitable for large projects)
331
346
  init_project_context --mode=modular
332
- # 生成:project-context.md(索引)+ 5 个分类文档
347
+ # Generates: project-context.md (index) + 5 category docs
333
348
  ```
334
349
 
335
- ### Git 工作报告
350
+ ### Git Work Report
336
351
  ```bash
337
- # 生成日报
338
- git_work_report --date 2026-1-27
352
+ # Generate daily report
353
+ git_work_report --date 2026-02-03
339
354
 
340
- # 生成周报
341
- git_work_report --start_date 2026-2-1 --end_date 2026-2-6
355
+ # Generate weekly report
356
+ git_work_report --start_date 2026-02-01 --end_date 2026-02-07
342
357
 
343
- # 保存到文件
344
- git_work_report --date 2026-1-27 --output_file daily-report.md
345
- # 自动分析 Git diff,生成简洁专业的中文工作报告
358
+ # Save to file
359
+ git_work_report --date 2026-02-03 --output_file daily-report.md
360
+ # Auto-analyze Git diff, generate concise professional report
361
+ # If direct command fails, auto-provides temp script solution (auto-deletes after execution)
346
362
  ```
347
363
 
348
- **👉 [更多使用示例](https://mcp-probe-kit.bytezonex.com/pages/examples.html)**
364
+ **👉 [More Usage Examples](https://mcp-probe-kit.bytezonex.com/pages/examples.html)**
349
365
 
350
366
  ---
351
367
 
352
- ## ❓ 常见问题
368
+ ## ❓ FAQ
353
369
 
354
- ### Q1: 工具无法使用或报错怎么办?
370
+ ### Q1: Tool not working or errors?
355
371
 
356
- 查看详细日志:
372
+ Check detailed logs:
357
373
 
358
374
  **Windows (PowerShell):**
359
375
  ```powershell
@@ -365,36 +381,36 @@ npx -y mcp-probe-kit@latest 2>&1 | Tee-Object -FilePath .\mcp-probe-kit.log
365
381
  npx -y mcp-probe-kit@latest 2>&1 | tee ./mcp-probe-kit.log
366
382
  ```
367
383
 
368
- ### Q2: 配置后客户端无法识别工具?
384
+ ### Q2: Client not recognizing tools after configuration?
369
385
 
370
- 1. **重启客户端**(完全退出后重新打开)
371
- 2. 检查配置文件路径是否正确
372
- 3. 确认 JSON 格式正确,没有语法错误
373
- 4. 查看客户端的开发者工具或日志中的错误信息
386
+ 1. **Restart client** (completely quit then reopen)
387
+ 2. Check config file path is correct
388
+ 3. Confirm JSON format is correct, no syntax errors
389
+ 4. Check client developer tools or logs for error messages
374
390
 
375
- ### Q3: 如何更新到最新版本?
391
+ ### Q3: How to update to latest version?
376
392
 
377
- **npx 方式(推荐):**
378
- 配置中使用 `@latest` 标签,会自动使用最新版本。
393
+ **npx method (Recommended):**
394
+ Use `@latest` tag in config, automatically uses latest version.
379
395
 
380
- **全局安装方式:**
396
+ **Global installation method:**
381
397
  ```bash
382
398
  npm update -g mcp-probe-kit
383
399
  ```
384
400
 
385
- **👉 [更多常见问题](https://mcp-probe-kit.bytezonex.com/pages/getting-started.html)**
401
+ **👉 [More FAQ](https://mcp-probe-kit.bytezonex.com/pages/getting-started.html)**
386
402
 
387
403
  ---
388
404
 
389
- ## 🤝 贡献指南
405
+ ## 🤝 Contributing
390
406
 
391
- 欢迎提交 Issue Pull Request!
407
+ Issues and Pull Requests welcome!
392
408
 
393
- **改进建议:**
394
- - 新增实用工具
395
- - 优化现有工具的提示词
396
- - 改进文档和示例
397
- - 修复 Bug
409
+ **Improvement suggestions:**
410
+ - Add useful tools
411
+ - Optimize existing tool prompts
412
+ - Improve documentation and examples
413
+ - Fix bugs
398
414
 
399
415
  ---
400
416
 
@@ -404,19 +420,19 @@ MIT License
404
420
 
405
421
  ---
406
422
 
407
- ## 🔗 相关链接
423
+ ## 🔗 Related Links
408
424
 
409
- - **作者**: [小墨 (Kyle)](https://www.bytezonex.com/)
425
+ - **Author**: [Kyle (小墨)](https://www.bytezonex.com/)
410
426
  - **GitHub**: [mcp-probe-kit](https://github.com/mybolide/mcp-probe-kit)
411
427
  - **npm**: [mcp-probe-kit](https://www.npmjs.com/package/mcp-probe-kit)
412
- - **文档**: [https://mcp-probe-kit.bytezonex.com](https://mcp-probe-kit.bytezonex.com/)
413
-
414
- **相关项目:**
415
- - [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) - MCP 协议官方文档
416
- - [GitHub Spec-Kit](https://github.com/github/spec-kit) - GitHub 规格化开发工具
417
- - [ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) - UI/UX 设计系统理念来源
418
- - [json-render](https://github.com/vercel-labs/json-render) - JSON 模板渲染引擎灵感来源
419
- - [uipro-cli](https://www.npmjs.com/package/uipro-cli) - UI/UX 数据源
428
+ - **Documentation**: [https://mcp-probe-kit.bytezonex.com](https://mcp-probe-kit.bytezonex.com/)
429
+
430
+ **Related Projects:**
431
+ - [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) - Official MCP protocol docs
432
+ - [GitHub Spec-Kit](https://github.com/github/spec-kit) - GitHub spec-driven development toolkit
433
+ - [ui-ux-pro-max-skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) - UI/UX design system philosophy source
434
+ - [json-render](https://github.com/vercel-labs/json-render) - JSON template rendering engine inspiration
435
+ - [uipro-cli](https://www.npmjs.com/package/uipro-cli) - UI/UX data source
420
436
 
421
437
  ---
422
438