mcp-probe-kit 1.15.0 → 2.0.0

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.
Files changed (165) hide show
  1. package/README.md +113 -1642
  2. package/build/index.js +75 -42
  3. package/build/lib/elicitation-helper.d.ts +73 -0
  4. package/build/lib/elicitation-helper.js +130 -0
  5. package/build/lib/response.d.ts +32 -0
  6. package/build/lib/response.js +28 -0
  7. package/build/lib/tasks-manager.d.ts +116 -0
  8. package/build/lib/tasks-manager.js +217 -0
  9. package/build/lib/toolset-manager.d.ts +48 -0
  10. package/build/lib/toolset-manager.js +112 -0
  11. package/build/schemas/basic-tools.d.ts +0 -32
  12. package/build/schemas/basic-tools.js +0 -34
  13. package/build/schemas/code-analysis-tools.d.ts +0 -36
  14. package/build/schemas/code-analysis-tools.js +0 -38
  15. package/build/schemas/code-gen-tools.d.ts +0 -44
  16. package/build/schemas/code-gen-tools.js +0 -46
  17. package/build/schemas/doc-util-tools.d.ts +0 -54
  18. package/build/schemas/doc-util-tools.js +0 -58
  19. package/build/schemas/index.d.ts +0 -188
  20. package/build/schemas/orchestration-tools.d.ts +0 -22
  21. package/build/schemas/orchestration-tools.js +0 -23
  22. package/build/schemas/output/core-tools.d.ts +817 -0
  23. package/build/schemas/output/core-tools.js +421 -0
  24. package/build/schemas/output/generation-tools.d.ts +936 -0
  25. package/build/schemas/output/generation-tools.js +446 -0
  26. package/build/schemas/output/helper-tools.d.ts +243 -0
  27. package/build/schemas/output/helper-tools.js +138 -0
  28. package/build/schemas/output/index.d.ts +76 -0
  29. package/build/schemas/output/index.js +96 -0
  30. package/build/schemas/output/project-tools.d.ts +702 -0
  31. package/build/schemas/output/project-tools.js +339 -0
  32. package/build/schemas/output/ui-ux-tools.d.ts +469 -0
  33. package/build/schemas/output/ui-ux-tools.js +218 -0
  34. package/build/schemas/output/workflow-tools.d.ts +267 -0
  35. package/build/schemas/output/workflow-tools.js +179 -0
  36. package/build/schemas/structured-output.d.ts +1317 -0
  37. package/build/schemas/structured-output.js +1017 -0
  38. package/build/tools/__tests__/start_ui.integration.test.js +5 -5
  39. package/build/tools/__tests__/start_ui.property.test.js +11 -11
  40. package/build/tools/add_feature.d.ts +1 -13
  41. package/build/tools/add_feature.js +48 -13
  42. package/build/tools/analyze_project.js +57 -18
  43. package/build/tools/check_deps.d.ts +1 -13
  44. package/build/tools/check_deps.js +24 -15
  45. package/build/tools/code_review.d.ts +1 -13
  46. package/build/tools/code_review.js +19 -16
  47. package/build/tools/css_order.js +55 -55
  48. package/build/tools/debug.d.ts +1 -13
  49. package/build/tools/debug.js +18 -16
  50. package/build/tools/estimate.d.ts +1 -19
  51. package/build/tools/estimate.js +36 -6
  52. package/build/tools/fix_bug.d.ts +1 -13
  53. package/build/tools/fix_bug.js +24 -6
  54. package/build/tools/gen_mock.d.ts +1 -19
  55. package/build/tools/gen_mock.js +42 -227
  56. package/build/tools/genapi.d.ts +1 -13
  57. package/build/tools/genapi.js +18 -15
  58. package/build/tools/genchangelog.d.ts +1 -13
  59. package/build/tools/genchangelog.js +36 -212
  60. package/build/tools/gencommit.d.ts +1 -7
  61. package/build/tools/gencommit.js +21 -13
  62. package/build/tools/gendoc.d.ts +1 -13
  63. package/build/tools/gendoc.js +18 -15
  64. package/build/tools/genpr.d.ts +1 -13
  65. package/build/tools/genpr.js +28 -157
  66. package/build/tools/genreadme.d.ts +1 -13
  67. package/build/tools/genreadme.js +22 -587
  68. package/build/tools/gensql.d.ts +1 -13
  69. package/build/tools/gensql.js +24 -283
  70. package/build/tools/gentest.d.ts +1 -13
  71. package/build/tools/gentest.js +49 -16
  72. package/build/tools/index.d.ts +0 -10
  73. package/build/tools/index.js +0 -10
  74. package/build/tools/init_component_catalog.d.ts +3 -20
  75. package/build/tools/init_component_catalog.js +141 -786
  76. package/build/tools/init_project.d.ts +7 -13
  77. package/build/tools/init_project.js +54 -16
  78. package/build/tools/init_project_context.d.ts +1 -13
  79. package/build/tools/init_project_context.js +41 -14
  80. package/build/tools/perf.d.ts +1 -13
  81. package/build/tools/perf.js +18 -15
  82. package/build/tools/refactor.d.ts +1 -13
  83. package/build/tools/refactor.js +54 -15
  84. package/build/tools/render_ui.d.ts +2 -19
  85. package/build/tools/render_ui.js +201 -347
  86. package/build/tools/resolve_conflict.d.ts +1 -13
  87. package/build/tools/resolve_conflict.js +18 -15
  88. package/build/tools/security_scan.d.ts +1 -13
  89. package/build/tools/security_scan.js +16 -5
  90. package/build/tools/start_api.d.ts +7 -13
  91. package/build/tools/start_api.js +69 -157
  92. package/build/tools/start_bugfix.d.ts +1 -7
  93. package/build/tools/start_bugfix.js +38 -2
  94. package/build/tools/start_doc.d.ts +7 -13
  95. package/build/tools/start_doc.js +76 -169
  96. package/build/tools/start_feature.d.ts +1 -7
  97. package/build/tools/start_feature.js +54 -2
  98. package/build/tools/start_onboard.d.ts +1 -7
  99. package/build/tools/start_onboard.js +40 -2
  100. package/build/tools/start_ralph.d.ts +1 -7
  101. package/build/tools/start_ralph.js +88 -2
  102. package/build/tools/start_refactor.d.ts +7 -13
  103. package/build/tools/start_refactor.js +75 -148
  104. package/build/tools/start_release.d.ts +7 -13
  105. package/build/tools/start_release.js +56 -131
  106. package/build/tools/start_review.d.ts +7 -13
  107. package/build/tools/start_review.js +70 -142
  108. package/build/tools/start_ui.d.ts +1 -7
  109. package/build/tools/start_ui.js +98 -8
  110. package/build/tools/ui-ux-tools.d.ts +3 -39
  111. package/build/tools/ui-ux-tools.js +201 -125
  112. package/docs/data/tools.js +864 -0
  113. package/docs/index.html +594 -0
  114. package/docs/pages/all-tools.html +649 -0
  115. package/docs/pages/examples.html +564 -0
  116. package/docs/pages/getting-started.html +529 -0
  117. package/docs/pages/migration.html +308 -0
  118. package/docs/specs/algorithm-enhancement/roadmap.md +619 -0
  119. package/docs/specs/vnext-upgrade/00-OVERVIEW.md +258 -0
  120. package/docs/specs/vnext-upgrade/BETA_RELEASE_GUIDE.md +328 -0
  121. package/docs/specs/vnext-upgrade/GITHUB_DISCUSSION_TEMPLATE.md +236 -0
  122. package/docs/specs/vnext-upgrade/M8.9-PROGRESS-UPDATE.md +248 -0
  123. package/docs/specs/vnext-upgrade/PROGRESS-SUMMARY.md +195 -0
  124. package/docs/specs/vnext-upgrade/QUICK_REFERENCE.md +338 -0
  125. package/docs/specs/vnext-upgrade/README.md +125 -0
  126. package/docs/specs/vnext-upgrade/STATUS-UPDATE-2026-01-26.md +230 -0
  127. package/docs/specs/vnext-upgrade/TOOL_CLEANUP.md +343 -0
  128. package/docs/specs/vnext-upgrade/completed/M1-M2-SUMMARY.md +27 -0
  129. package/docs/specs/vnext-upgrade/completed/M3_COMPLETION_SUMMARY.md +273 -0
  130. package/docs/specs/vnext-upgrade/completed/M4-SUMMARY.md +19 -0
  131. package/docs/specs/vnext-upgrade/completed/M5_COMPLETION_SUMMARY.md +0 -0
  132. package/docs/specs/vnext-upgrade/completed/M8.1-SUMMARY.md +247 -0
  133. package/docs/specs/vnext-upgrade/completed/M8.2-SUMMARY.md +296 -0
  134. package/docs/specs/vnext-upgrade/completed/M8.3-SUMMARY.md +241 -0
  135. package/docs/specs/vnext-upgrade/completed/M8.3-TEST-SUMMARY.md +216 -0
  136. package/docs/specs/vnext-upgrade/completed/M8.4-SUMMARY.md +217 -0
  137. package/docs/specs/vnext-upgrade/completed/M8.4-TEST-SUMMARY.md +198 -0
  138. package/docs/specs/vnext-upgrade/completed/M8.5-SUMMARY.md +202 -0
  139. package/docs/specs/vnext-upgrade/completed/M8.5-TEST-SUMMARY.md +223 -0
  140. package/docs/specs/vnext-upgrade/completed/M8.6-SUMMARY.md +299 -0
  141. package/docs/specs/vnext-upgrade/completed/M8.8-TEST-SUMMARY.md +216 -0
  142. package/docs/specs/vnext-upgrade/completed/TOOL-CLEANUP-SUMMARY.md +210 -0
  143. package/docs/specs/vnext-upgrade/design.md +848 -0
  144. package/docs/specs/vnext-upgrade/requirements.md +221 -0
  145. package/docs/specs/vnext-upgrade/tasks/00-INDEX.md +335 -0
  146. package/docs/specs/vnext-upgrade/tasks/M8.1-SCHEMA-DEFINITION.md +300 -0
  147. package/docs/specs/vnext-upgrade/tasks/M8.2-P1-TOOLS.md +249 -0
  148. package/docs/specs/vnext-upgrade/tasks/M8.3-GENERATION-TOOLS.md +49 -0
  149. package/docs/specs/vnext-upgrade/tasks/M8.4-ORCHESTRATION-TOOLS.md +28 -0
  150. package/docs/specs/vnext-upgrade/tasks/M8.5-PROJECT-TOOLS.md +29 -0
  151. package/docs/specs/vnext-upgrade/tasks/M8.6-UI-TOOLS.md +66 -0
  152. package/docs/specs/vnext-upgrade/tasks/M8.7-HELPER-TOOLS.md +24 -0
  153. package/docs/specs/vnext-upgrade/tasks/M8.8-INTEGRATION-TESTS.md +90 -0
  154. package/docs/specs/vnext-upgrade/tasks/M8.9-DOCUMENTATION.md +103 -0
  155. package/docs/styles/docs.css +556 -0
  156. package/docs/styles/page.css +815 -0
  157. package/docs/vnext/MCP_2025-11-25_GUIDE.md +276 -0
  158. package/docs/vnext/vNext-PRD.md +488 -0
  159. package/package.json +4 -4
  160. package/build/utils/design-docs-generator.d.ts +0 -1
  161. package/build/utils/design-docs-generator.js +0 -1
  162. package/docs/BEST_PRACTICES.md +0 -1185
  163. package/docs/HOW_TO_TRIGGER.md +0 -1141
  164. package/docs/MCP-Probe-Kit-/344/275/277/347/224/250/346/211/213/345/206/214.html +0 -544
  165. package/docs/MCP-Probe-Kit-/344/275/277/347/224/250/346/211/213/345/206/214.md +0 -1447
package/docs/pages/getting-started.html ADDED
@@ -0,0 +1,529 @@
1
+ <!DOCTYPE html>
2
+ <html lang="zh-CN">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>快速开始 - 安装配置指南 | MCP Probe Kit</title>
7
+
8
+ <!-- SEO Meta Tags -->
9
+ <meta name="description" content="MCP Probe Kit 快速开始指南：支持 Cursor、Cline、Claude Desktop 三大平台，5分钟完成安装配置。详细的 npx 和 npm 安装教程，快速接入 AI 研发工具集。">
10
+ <meta name="keywords" content="MCP Probe Kit 安装, Cursor 配置, Cline 配置, Claude Desktop 配置, MCP Server 安装, AI 开发工具安装, npx 安装">
11
+ <meta name="author" content="小墨 (Kyle) - ByteZoneX">
12
+ <meta name="robots" content="index, follow">
13
+ <link rel="canonical" href="https://mcp-probe-kit.bytezonex.com/pages/getting-started.html">
14
+ <link rel="icon" type="image/x-icon" href="https://www.bytezonex.com/favicon.ico">
15
+
16
+ <!-- Open Graph / Facebook -->
17
+ <meta property="og:type" content="article">
18
+ <meta property="og:url" content="https://mcp-probe-kit.bytezonex.com/pages/getting-started.html">
19
+ <meta property="og:title" content="快速开始 - 安装配置指南 | MCP Probe Kit">
20
+ <meta property="og:description" content="5分钟快速安装 MCP Probe Kit，支持 Cursor、Cline、Claude Desktop。详细配置教程，立即开始使用 39 个 AI 研发工具。">
21
+
22
+ <!-- Twitter -->
23
+ <meta property="twitter:card" content="summary_large_image">
24
+ <meta property="twitter:url" content="https://mcp-probe-kit.bytezonex.com/pages/getting-started.html">
25
+ <meta property="twitter:title" content="快速开始 - 安装配置指南 | MCP Probe Kit">
26
+ <meta property="twitter:description" content="5分钟快速安装 MCP Probe Kit，支持 Cursor、Cline、Claude Desktop。">
27
+
28
+ <link rel="stylesheet" href="../styles/page.css">
29
+ </head>
30
+ <body>
31
+ <!-- A. Topbar -->
32
+ <nav class="topbar" id="topbar">
33
+ <div class="topbar-container">
34
+ <a href="../index.html" class="topbar-brand">
35
+ <span>🚀</span>
36
+ <span>MCP Probe Kit</span>
37
+ </a>
38
+
39
+ <div class="topbar-actions">
40
+ <a href="https://www.bytezonex.com/" target="_blank" rel="noopener" class="topbar-link external">
41
+ <span>ByteZoneX</span>
42
+ </a>
43
+ <a href="https://github.com/mybolide/mcp-probe-kit" target="_blank" rel="noopener" class="topbar-link external">
44
+ <span>GitHub</span>
45
+ </a>
46
+ <a href="https://www.npmjs.com/package/mcp-probe-kit" target="_blank" rel="noopener" class="topbar-link external">
47
+ <span>npm</span>
48
+ </a>
49
+ </div>
50
+ </div>
51
+ </nav>
52
+
53
+
54
+ <!-- Layout Container -->
55
+ <div class="layout">
56
+ <!-- C. Sidebar -->
57
+ <aside class="sidebar" id="sidebar">
58
+ <nav class="sidebar-nav">
59
+ <div class="nav-section">
60
+ <div class="nav-section-title">快速开始</div>
61
+ <a href="../index.html" class="nav-item">
62
+ <div class="nav-item-content">
63
+ <span class="icon">🏠</span>
64
+ <span>文档首页</span>
65
+ </div>
66
+ </a>
67
+ <a href="./getting-started.html" class="nav-item active">
68
+ <div class="nav-item-content">
69
+ <span class="icon">📖</span>
70
+ <span>安装配置</span>
71
+ </div>
72
+ </a>
73
+ </div>
74
+
75
+ <div class="nav-section">
76
+ <div class="nav-section-title">工具文档</div>
77
+ <a href="./all-tools.html" class="nav-item">
78
+ <div class="nav-item-content">
79
+ <span class="icon">🛠️</span>
80
+ <span>所有工具</span>
81
+ </div>
82
+ <span class="badge">39</span>
83
+ </a>
84
+ </div>
85
+
86
+ <div class="nav-section">
87
+ <div class="nav-section-title">指南</div>
88
+ <a href="./migration.html" class="nav-item">
89
+ <div class="nav-item-content">
90
+ <span class="icon">🚀</span>
91
+ <span>迁移指南</span>
92
+ </div>
93
+ </a>
94
+ <a href="./examples.html" class="nav-item">
95
+ <div class="nav-item-content">
96
+ <span class="icon">💡</span>
97
+ <span>最佳实践</span>
98
+ </div>
99
+ </a>
100
+ </div>
101
+
102
+
103
+ <div class="nav-section">
104
+ <div class="nav-section-title">资源</div>
105
+ <a href="https://www.bytezonex.com/" target="_blank" rel="noopener" class="nav-item">
106
+ <div class="nav-item-content">
107
+ <span class="icon">🌐</span>
108
+ <span>ByteZoneX 主站</span>
109
+ </div>
110
+ <span class="external-icon">↗</span>
111
+ </a>
112
+ <a href="https://github.com/mybolide/mcp-probe-kit" target="_blank" rel="noopener" class="nav-item">
113
+ <div class="nav-item-content">
114
+ <span class="icon">💻</span>
115
+ <span>GitHub 仓库</span>
116
+ </div>
117
+ <span class="external-icon">↗</span>
118
+ </a>
119
+ <a href="https://www.npmjs.com/package/mcp-probe-kit" target="_blank" rel="noopener" class="nav-item">
120
+ <div class="nav-item-content">
121
+ <span class="icon">📦</span>
122
+ <span>npm 包</span>
123
+ </div>
124
+ <span class="external-icon">↗</span>
125
+ </a>
126
+ <a href="https://github.com/mybolide/mcp-probe-kit/issues" target="_blank" rel="noopener" class="nav-item">
127
+ <div class="nav-item-content">
128
+ <span class="icon">🐛</span>
129
+ <span>问题反馈</span>
130
+ </div>
131
+ <span class="external-icon">↗</span>
132
+ </a>
133
+ </div>
134
+ </nav>
135
+
136
+ <!-- Sidebar Footer -->
137
+ <div class="sidebar-footer">
138
+ <div class="sidebar-footer-title">快速链接</div>
139
+ <div class="sidebar-footer-links">
140
+ <a href="https://www.bytezonex.com/" target="_blank" rel="noopener" class="sidebar-footer-link">
141
+ <span>🌐</span>
142
+ <span>ByteZoneX</span>
143
+ <span class="external-icon">↗</span>
144
+ </a>
145
+ <a href="https://github.com/mybolide/mcp-probe-kit" target="_blank" rel="noopener" class="sidebar-footer-link">
146
+ <span>💻</span>
147
+ <span>GitHub</span>
148
+ <span class="external-icon">↗</span>
149
+ </a>
150
+ <a href="https://www.npmjs.com/package/mcp-probe-kit" target="_blank" rel="noopener" class="sidebar-footer-link">
151
+ <span>📦</span>
152
+ <span>npm</span>
153
+ <span class="external-icon">↗</span>
154
+ </a>
155
+ </div>
156
+
157
+ <!-- QR Code -->
158
+ <div class="sidebar-qrcode">
159
+ <div class="sidebar-qrcode-title">关注公众号</div>
160
+ <img src="https://oss.bolzjb.com/wx_qrcode.jpg" alt="微信公众号" />
161
+ <div class="sidebar-qrcode-desc">获取更多技术分享</div>
162
+ </div>
163
+ </div>
164
+ </aside>
165
+
166
+
167
+ <!-- D. Main Content -->
168
+ <main class="main-content">
169
+ <div class="content-wrapper">
170
+ <!-- Breadcrumb -->
171
+ <nav class="breadcrumb">
172
+ <a href="../index.html">文档首页</a>
173
+ <span class="breadcrumb-separator">/</span>
174
+ <a href="#">快速开始</a>
175
+ <span class="breadcrumb-separator">/</span>
176
+ <span>安装配置</span>
177
+ </nav>
178
+
179
+ <!-- Page Header -->
180
+ <h1 class="page-title">安装配置</h1>
181
+ <p class="page-description">5 分钟快速上手 MCP Probe Kit v2.0，支持 Cursor、Cline 和 Claude Desktop</p>
182
+ <div class="page-meta">
183
+ <span>📦 v2.0.0</span>
184
+ <span>·</span>
185
+ <span>最后更新：2026-01-27</span>
186
+ <span>·</span>
187
+ <a href="https://github.com/mybolide/mcp-probe-kit/edit/main/docs/pages/getting-started.html" target="_blank" rel="noopener">编辑此页 ↗</a>
188
+ <span>·</span>
189
+ <a href="https://github.com/mybolide/mcp-probe-kit/issues/new" target="_blank" rel="noopener">反馈问题 ↗</a>
190
+ </div>
191
+
192
+ <!-- Step 1: 安装方式 -->
193
+ <div class="step-card">
194
+ <div class="step-header">
195
+ <div class="step-number">1</div>
196
+ <h3 class="step-title">选择安装方式</h3>
197
+ </div>
198
+ <div class="step-content">
199
+ <div class="tabs" id="install-tabs">
200
+ <div class="tabs-header">
201
+ <button class="tab-button active" data-tab="npx">
202
+ npx 直接使用
203
+ <span class="recommended">推荐</span>
204
+ </button>
205
+ <button class="tab-button" data-tab="global">全局安装</button>
206
+ <button class="tab-button" data-tab="source">源码编译</button>
207
+ </div>
208
+
209
+ <div class="tab-content active" id="npx">
210
+ <p>无需安装，直接使用最新版本（推荐方式）：</p>
211
+ <div class="code-block">
212
+ <div class="code-header">
213
+ <span class="code-language">JSON</span>
214
+ <button class="copy-button" onclick="copyCode(this, 'npx-code')">
215
+ <span>📋</span>
216
+ <span>复制</span>
217
+ </button>
218
+ </div>
219
+ <pre><code id="npx-code">{
220
+ "mcpServers": {
221
+ "mcp-probe-kit": {
222
+ "command": "npx",
223
+ "args": ["-y", "mcp-probe-kit@latest"]
224
+ }
225
+ }
226
+ }</code></pre>
227
+ </div>
228
+ <div class="callout info">
229
+ <div class="callout-icon">💡</div>
230
+ <div class="callout-content">
231
+ <p><strong>优势：</strong>无需手动更新，每次启动自动使用最新版本，适合快速体验和持续跟进新功能。</p>
232
+ </div>
233
+ </div>
234
+ </div>
235
+
236
+
237
+ <div class="tab-content" id="global">
238
+ <p>全局安装到系统，适合稳定使用：</p>
239
+ <div class="code-block">
240
+ <div class="code-header">
241
+ <span class="code-language">Bash</span>
242
+ <button class="copy-button" onclick="copyCode(this, 'global-install')">
243
+ <span>📋</span>
244
+ <span>复制</span>
245
+ </button>
246
+ </div>
247
+ <pre><code id="global-install">npm install -g mcp-probe-kit</code></pre>
248
+ </div>
249
+ <p>配置文件：</p>
250
+ <div class="code-block">
251
+ <div class="code-header">
252
+ <span class="code-language">JSON</span>
253
+ <button class="copy-button" onclick="copyCode(this, 'global-config')">
254
+ <span>📋</span>
255
+ <span>复制</span>
256
+ </button>
257
+ </div>
258
+ <pre><code id="global-config">{
259
+ "mcpServers": {
260
+ "mcp-probe-kit": {
261
+ "command": "mcp-probe-kit"
262
+ }
263
+ }
264
+ }</code></pre>
265
+ </div>
266
+ <div class="callout warning">
267
+ <div class="callout-icon">⚠️</div>
268
+ <div class="callout-content">
269
+ <p><strong>注意：</strong>需要手动运行 <code>npm update -g mcp-probe-kit</code> 来更新版本。</p>
270
+ </div>
271
+ </div>
272
+ </div>
273
+
274
+ <div class="tab-content" id="source">
275
+ <p>从源码编译安装，适合开发者和贡献者：</p>
276
+
277
+ <p><strong>1. 克隆仓库</strong></p>
278
+ <div class="code-block">
279
+ <div class="code-header">
280
+ <span class="code-language">Bash</span>
281
+ <button class="copy-button" onclick="copyCode(this, 'source-clone')">
282
+ <span>📋</span>
283
+ <span>复制</span>
284
+ </button>
285
+ </div>
286
+ <pre><code id="source-clone">git clone https://github.com/mybolide/mcp-probe-kit.git
287
+ cd mcp-probe-kit</code></pre>
288
+ </div>
289
+
290
+ <p><strong>2. 安装依赖并编译</strong></p>
291
+ <div class="code-block">
292
+ <div class="code-header">
293
+ <span class="code-language">Bash</span>
294
+ <button class="copy-button" onclick="copyCode(this, 'source-build')">
295
+ <span>📋</span>
296
+ <span>复制</span>
297
+ </button>
298
+ </div>
299
+ <pre><code id="source-build">npm install
300
+ npm run build</code></pre>
301
+ </div>
302
+
303
+ <p><strong>3. 配置文件</strong></p>
304
+ <div class="code-block">
305
+ <div class="code-header">
306
+ <span class="code-language">JSON</span>
307
+ <button class="copy-button" onclick="copyCode(this, 'source-config')">
308
+ <span>📋</span>
309
+ <span>复制</span>
310
+ </button>
311
+ </div>
312
+ <pre><code id="source-config">{
313
+ "mcpServers": {
314
+ "mcp-probe-kit": {
315
+ "command": "node",
316
+ "args": ["/path/to/mcp-probe-kit/build/index.js"]
317
+ }
318
+ }
319
+ }</code></pre>
320
+ </div>
321
+
322
+ <div class="callout info">
323
+ <div class="callout-icon">💡</div>
324
+ <div class="callout-content">
325
+ <p><strong>提示：</strong>将 <code>/path/to/mcp-probe-kit</code> 替换为实际的项目路径。Windows 用户使用完整路径，如 <code>D:/workspace/mcp-probe-kit/build/index.js</code></p>
326
+ </div>
327
+ </div>
328
+
329
+ <div class="callout warning">
330
+ <div class="callout-icon">⚠️</div>
331
+ <div class="callout-content">
332
+ <p><strong>注意：</strong>修改代码后需要重新运行 <code>npm run build</code> 编译，然后重启 MCP 客户端。</p>
333
+ </div>
334
+ </div>
335
+ </div>
336
+ </div>
337
+ </div>
338
+ </div>
339
+
340
+
341
+ <!-- Step 2: 配置文件位置 -->
342
+ <div class="step-card">
343
+ <div class="step-header">
344
+ <div class="step-number">2</div>
345
+ <h3 class="step-title">找到配置文件</h3>
346
+ </div>
347
+ <div class="step-content">
348
+ <p>根据你使用的 MCP 客户端，找到对应的配置文件：</p>
349
+
350
+ <div class="tabs" id="client-tabs">
351
+ <div class="tabs-header">
352
+ <button class="tab-button active" data-tab="cursor">Cursor / Cline</button>
353
+ <button class="tab-button" data-tab="claude-windows">Claude Desktop (Windows)</button>
354
+ <button class="tab-button" data-tab="claude-macos">Claude Desktop (macOS)</button>
355
+ </div>
356
+
357
+ <div class="tab-content active" id="cursor">
358
+ <p>在项目根目录创建或编辑 <code>.cursor/mcp.json</code> 或 <code>.cline/mcp.json</code></p>
359
+ <div class="callout info">
360
+ <div class="callout-icon">💡</div>
361
+ <div class="callout-content">
362
+ <p>Cursor 和 Cline 使用项目级配置，每个项目可以有独立的 MCP 服务器配置。</p>
363
+ </div>
364
+ </div>
365
+ </div>
366
+
367
+ <div class="tab-content" id="claude-windows">
368
+ <p>配置文件路径：</p>
369
+ <div class="code-block">
370
+ <div class="code-header">
371
+ <span class="code-language">Path</span>
372
+ <button class="copy-button" onclick="copyCode(this, 'windows-path')">
373
+ <span>📋</span>
374
+ <span>复制</span>
375
+ </button>
376
+ </div>
377
+ <pre><code id="windows-path">%APPDATA%\Claude\claude_desktop_config.json</code></pre>
378
+ </div>
379
+ <p>完整路径示例：<code>C:\Users\YourName\AppData\Roaming\Claude\claude_desktop_config.json</code></p>
380
+ </div>
381
+
382
+ <div class="tab-content" id="claude-macos">
383
+ <p>配置文件路径：</p>
384
+ <div class="code-block">
385
+ <div class="code-header">
386
+ <span class="code-language">Path</span>
387
+ <button class="copy-button" onclick="copyCode(this, 'macos-path')">
388
+ <span>📋</span>
389
+ <span>复制</span>
390
+ </button>
391
+ </div>
392
+ <pre><code id="macos-path">~/Library/Application Support/Claude/claude_desktop_config.json</code></pre>
393
+ </div>
394
+ </div>
395
+ </div>
396
+ </div>
397
+ </div>
398
+
399
+
400
+ <!-- Step 3: 验证安装 -->
401
+ <div class="step-card">
402
+ <div class="step-header">
403
+ <div class="step-number">3</div>
404
+ <h3 class="step-title">验证安装</h3>
405
+ </div>
406
+ <div class="step-content">
407
+ <p>完成配置后，按以下步骤验证：</p>
408
+ <ol>
409
+ <li>重启 MCP 客户端（Cursor / Cline / Claude Desktop）</li>
410
+ <li>在聊天窗口中输入测试命令：<code>请使用 gencommit 工具生成一个测试提交消息</code></li>
411
+ <li>如果返回符合 Conventional Commits 规范的提交消息，说明安装成功！</li>
412
+ </ol>
413
+
414
+ <div class="callout success">
415
+ <div class="callout-icon">✅</div>
416
+ <div class="callout-content">
417
+ <p><strong>成功示例：</strong></p>
418
+ <p>AI 返回类似 <code>feat: 添加用户认证功能</code> 或 <code>fix: 修复登录页面样式问题</code> 的消息。</p>
419
+ </div>
420
+ </div>
421
+
422
+ <div class="callout error">
423
+ <div class="callout-icon">❌</div>
424
+ <div class="callout-content">
425
+ <p><strong>常见问题：</strong></p>
426
+ <ul>
427
+ <li>如果提示"找不到工具"，检查配置文件格式是否正确</li>
428
+ <li>如果提示"命令不存在"，确认 Node.js 和 npm 已正确安装</li>
429
+ <li>Windows 用户：确保使用完整路径或 npx 方式</li>
430
+ </ul>
431
+ </div>
432
+ </div>
433
+ </div>
434
+ </div>
435
+
436
+ <!-- Next Steps CTA -->
437
+ <div class="next-cta">
438
+ <h3>🎉 安装完成！下一步</h3>
439
+ <p>探索 MCP Probe Kit 的强大功能，提升你的开发效率</p>
440
+ <div class="next-cta-links">
441
+ <a href="./all-tools.html" class="next-cta-link">
442
+ <span>🛠️</span>
443
+ <span>查看所有工具</span>
444
+ </a>
445
+ <a href="./examples.html" class="next-cta-link">
446
+ <span>💡</span>
447
+ <span>学习最佳实践</span>
448
+ </a>
449
+ <a href="https://github.com/mybolide/mcp-probe-kit" target="_blank" rel="noopener" class="next-cta-link">
450
+ <span>💻</span>
451
+ <span>GitHub 仓库</span>
452
+ </a>
453
+ </div>
454
+ </div>
455
+ </div>
456
+
457
+ <!-- Footer -->
458
+ <footer class="footer">
459
+ <div class="footer-container">
460
+ <div>Made with ❤️ by <a href="https://www.bytezonex.com/" target="_blank" rel="noopener">小墨 (Kyle)</a></div>
461
+ <div>
462
+ © 2024-2026 MCP Probe Kit · MIT License ·
463
+ <a href="https://www.bytezonex.com/" target="_blank" rel="noopener">主站 ByteZoneX ↗</a>
464
+ </div>
465
+ </div>
466
+ </footer>
467
+ </main>
468
+ </div>
469
+
470
+
471
+ <!-- Mobile Menu Button -->
472
+ <button class="mobile-menu-btn" onclick="toggleSidebar()">☰</button>
473
+
474
+ <script>
475
+ // Topbar scroll effect
476
+ const topbar = document.getElementById('topbar');
477
+ window.addEventListener('scroll', () => {
478
+ if (window.pageYOffset > 10) {
479
+ topbar.classList.add('scrolled');
480
+ } else {
481
+ topbar.classList.remove('scrolled');
482
+ }
483
+ });
484
+
485
+ // Sidebar toggle (mobile)
486
+ function toggleSidebar() {
487
+ document.getElementById('sidebar').classList.toggle('open');
488
+ }
489
+
490
+ // Close sidebar when clicking outside (mobile)
491
+ if (window.innerWidth <= 768) {
492
+ document.querySelector('.main-content').addEventListener('click', function() {
493
+ document.getElementById('sidebar').classList.remove('open');
494
+ });
495
+ }
496
+
497
+ // Tabs functionality
498
+ document.querySelectorAll('.tab-button').forEach(button => {
499
+ button.addEventListener('click', function() {
500
+ const tabsContainer = this.closest('.tabs');
501
+ const targetTab = this.getAttribute('data-tab');
502
+
503
+ // Remove active class from all buttons and contents in this tabs container
504
+ tabsContainer.querySelectorAll('.tab-button').forEach(btn => btn.classList.remove('active'));
505
+ tabsContainer.querySelectorAll('.tab-content').forEach(content => content.classList.remove('active'));
506
+
507
+ // Add active class to clicked button and corresponding content
508
+ this.classList.add('active');
509
+ document.getElementById(targetTab).classList.add('active');
510
+ });
511
+ });
512
+
513
+ // Copy code functionality
514
+ function copyCode(button, codeId) {
515
+ const code = document.getElementById(codeId).textContent;
516
+ navigator.clipboard.writeText(code).then(() => {
517
+ const originalHTML = button.innerHTML;
518
+ button.innerHTML = '<span>✓</span><span>已复制</span>';
519
+ button.classList.add('copied');
520
+
521
+ setTimeout(() => {
522
+ button.innerHTML = originalHTML;
523
+ button.classList.remove('copied');
524
+ }, 2000);
525
+ });
526
+ }
527
+ </script>
528
+ </body>
529
+ </html>