@ai-jshook/mcp 0.1.1 → 0.1.3

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,564 +1,471 @@
1
- # JSHook Reverse Tool
2
-
3
- <div align="center">
4
-
5
- AI 助手成为你的浏览器逆向专家 | Let AI be your browser reverse engineering expert
6
-
7
- [![npm version](https://img.shields.io/npm/v/@ai-jshook/mcp.svg)](https://www.npmjs.com/package/@ai-jshook/mcp)
8
- [![npm downloads](https://img.shields.io/npm/dm/@ai-jshook/mcp.svg)](https://www.npmjs.com/package/@ai-jshook/mcp)
9
- [![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io/servers/io.github.715494637.ai-jshook)
10
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
11
- [![Node Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)
12
- [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue)](https://www.typescriptlang.org/)
13
- [![MCP](https://img.shields.io/badge/MCP-Protocol-orange)](https://modelcontextprotocol.io/)
14
-
15
- [快速开始](#快速开始) • [核心功能](#核心功能) • [使用场景](#使用场景) • [文档](#文档)
16
-
17
- </div>
18
-
19
- ---
20
-
21
- ## ⚡ 一键安装
22
-
23
- ### 从 npm 安装
24
-
25
- ```bash
26
- # 使用 npx(无需安装)
27
- npx @ai-jshook/mcp
28
-
29
- # 或全局安装
30
- npm install -g @ai-jshook/mcp
31
-
32
- ```
33
-
34
- ## 什么是 JSHook?
35
-
36
- JSHook 是一个基于 **MCP (Model Context Protocol)** 的 JavaScript 逆向工程工具,通过 **80+ 个专业工具**,让 Claude、ChatGPT 等 AI 助手能够自动化完成复杂的网页分析、调试和逆向任务。
37
-
38
- ### 为什么选择 JSHook?
39
-
40
- - **AI 原生设计** - 专为 AI 助手优化,自然语言即可操作
41
- - **反检测能力** - 集成 2024-2025 最新反爬虫技术
42
- - **深度调试** - Chrome DevTools Protocol 完整集成
43
- - **网络拦截** - 捕获所有 HTTP 请求/响应
44
- - **智能 Hook** - AI 自动生成 Hook 代码
45
- - **验证码识别** - AI 视觉识别各类验证码
46
-
47
- ---
48
-
49
- ## 核心功能
50
-
51
- ### 1. 浏览器自动化 (35 个工具)
52
-
53
- 完整的浏览器控制能力,从页面导航到 DOM 操作,从截图到设备模拟。
54
-
55
- ```javascript
56
- // 示例:自动化登录流程
57
- browser_launch()
58
- stealth_inject() // 注入反检测脚本
59
- page_navigate(url="https://example.com/login")
60
- page_type(selector="#username", text="user@example.com")
61
- page_type(selector="#password", text="********")
62
- page_click(selector="#loginBtn")
63
- ```
64
-
65
- **亮点功能**:
66
- - 2024-2025 最新反检测技术(隐藏 webdriver、Canvas指纹处理)
67
- - ✅ AI 视觉验证码识别(滑块/图形/reCAPTCHA)
68
- - 智能等待和自动重试
69
- - ✅ 移动设备模拟
70
-
71
- ### 2. 专业调试器 (38 个工具)
72
-
73
- 基于 Chrome DevTools Protocol,提供 IDE 级别的调试能力。
74
-
75
- ```javascript
76
- // 示例:调试加密算法
77
- debugger_enable()
78
-
79
- // 在所有加密API调用处暂停
80
- xhr_breakpoint_set(urlPattern="*/api/sign*")
81
- event_breakpoint_set(eventName="fetch")
82
-
83
- // 监控关键变量
84
- watch_add(expression="window.crypto_params", name="加密参数")
85
-
86
- // 等待断点命中
87
- debugger_wait_for_paused()
88
- get_call_stack() // 查看调用栈
89
- watch_evaluate_all() // 查看所有监控变量
90
- ```
91
-
92
- **亮点功能**:
93
- - ✅ 代码断点、条件断点、异常断点
94
- - XHR/Fetch 断点(拦截网络请求)
95
- - ✅ 事件断点(点击、定时器、WebSocket)
96
- - ✅ Watch 表达式、调用栈分析
97
- - ✅ Blackboxing(屏蔽第三方库)
98
- - 调试会话保存/加载
99
-
100
- ### 3. 网络监控 (6 个工具)
101
-
102
- 捕获和分析所有 HTTP 流量,支持请求过滤和响应解析。
103
-
104
- ```javascript
105
- // 示例:分析 API 请求
106
- network_enable()
107
- page_navigate(url="https://api.example.com")
108
-
109
- // 过滤包含 "api" 的请求
110
- network_get_requests(url="api", method="POST")
111
-
112
- // 查看响应体
113
- network_get_response_body(requestId="xxx")
114
-
115
- // 统计分析
116
- network_get_stats()
117
- ```
118
-
119
- **亮点功能**:
120
- - ✅ 捕获请求头、POST 数据、响应体
121
- - ✅ 智能过滤(URL、方法、类型)
122
- - ✅ 统计分析(请求数、失败率、耗时)
123
-
124
- ### 4. AI Hook 生成器 (7 个工具)
125
-
126
- 用自然语言描述需求,AI 自动生成专业的 Hook 代码。
127
-
128
- ```javascript
129
- // 示例:Hook Fetch API
130
- ai_hook_generate({
131
- description: "监控所有 API 请求,记录 URL 和参数",
132
- target: { type: "api", name: "fetch" },
133
- behavior: {
134
- captureArgs: true,
135
- captureReturn: true,
136
- logToConsole: true
137
- },
138
- condition: {
139
- urlPattern: ".*api.*"
140
- }
141
- })
142
-
143
- // 注入 Hook(必须在页面加载前)
144
- ai_hook_inject(hookId="fetch-hook", method="evaluateOnNewDocument")
145
-
146
- // 获取捕获的数据
147
- ai_hook_get_data(hookId="fetch-hook")
148
- ```
149
-
150
- **支持的 Hook 类型**:
151
- - 🎯 函数 Hook(`btoa`, `atob`, `eval`)
152
- - 🎯 API Hook(`fetch`, `XMLHttpRequest`, `WebSocket`)
153
- - 🎯 对象方法(`crypto.subtle.encrypt`)
154
- - 🎯 属性拦截、事件监听
155
-
156
- ### 5. 性能分析 (4 个工具)
157
-
158
- Web Vitals 指标、代码覆盖率、内存快照。
159
-
160
- ```javascript
161
- performance_get_metrics(includeTimeline=true)
162
- performance_start_coverage() // 启动覆盖率收集
163
- // ... 操作页面 ...
164
- performance_stop_coverage() // 获取未使用的代码
165
- performance_take_heap_snapshot() // 内存分析
166
- ```
167
-
168
- ### 6. 缓存与预算管理 (6 个工具)
169
-
170
- 智能管理 Token 预算和缓存,防止上下文溢出。
171
-
172
- ```javascript
173
- get_token_budget_stats() // 查看 Token 使用情况
174
- get_cache_stats() // 查看缓存统计
175
-
176
- // Token 使用率 > 80% 时
177
- manual_token_cleanup() // 清理 Token
178
- smart_cache_cleanup() // 智能清理缓存
179
- ```
180
-
181
- ---
182
-
183
- ## 使用场景
184
-
185
- ### 🔓 网页逆向
186
-
187
- - 分析混淆加密的 JavaScript 代码
188
- - 定位加密算法和签名生成逻辑
189
- - 提取 API 请求参数
190
-
191
- ### 🕷️ 爬虫开发
192
-
193
- - 突破反爬虫检测(webdriver、Canvas指纹)
194
- - 自动处理验证码(滑块/图形/reCAPTCHA)
195
- - 捕获动态加载数据
196
-
197
- ### 🛡️ 安全测试
198
-
199
- - 漏洞挖掘和渗透测试
200
- - XSS/CSRF 检测
201
- - API 安全分析
202
-
203
- ### ⚡ 性能优化
204
-
205
- - 识别无用代码(代码覆盖率)
206
- - 分析加载性能(Web Vitals)
207
- - 内存泄漏检测
208
-
209
- ---
210
-
211
- ## 快速开始
212
-
213
- ### 环境要求
214
-
215
- - **Node.js**: >= 18.0.0
216
- - **操作系统**: Windows / macOS / Linux
217
- - **LLM API**: OpenAI 或 Anthropic API Key
218
-
219
- ### 安装方式
220
-
221
- #### 方式一:直接使用 npx(推荐)⭐
222
-
223
- 无需安装,直接配置即可使用。编辑 Claude Desktop 配置文件 `claude_desktop_config.json`:
224
-
225
- ```json
226
- {
227
- "mcpServers": {
228
- "jshook": {
229
- "command": "npx",
230
- "args": ["-y", "ai-jshook"],
231
- "env": {
232
- "OPENAI_API_KEY": "sk-...",
233
- "DEFAULT_LLM_PROVIDER": "openai"
234
- }
235
- }
236
- }
237
- }
238
- ```
239
-
240
- #### 方式二:全局安装
241
-
242
- ```bash
243
- npm install -g @ai-jshook/mcp
244
- ```
245
-
246
- 配置文件:
247
- ```json
248
- {
249
- "mcpServers": {
250
- "jshook": {
251
- "command": "ai-jshook-mcp",
252
- "env": {
253
- "OPENAI_API_KEY": "sk-...",
254
- "DEFAULT_LLM_PROVIDER": "openai"
255
- }
256
- }
257
- }
258
- }
259
- ```
260
-
261
- #### 方式三:从源码安装(开发者)
262
-
263
- ```bash
264
- git clone https://github.com/715494637/jshook-reverse-tool.git
265
- cd jshook-reverse-tool
266
- npm install
267
- npm run build
268
- ```
269
-
270
- 配置文件:
271
- ```json
272
- {
273
- "mcpServers": {
274
- "jshook": {
275
- "command": "node",
276
- "args": ["C:/path/to/jshook/dist/index.js"],
277
- "env": {
278
- "OPENAI_API_KEY": "sk-...",
279
- "DEFAULT_LLM_PROVIDER": "openai"
280
- }
281
- }
282
- }
283
- }
284
- ```
285
-
286
- ### 环境变量配置
287
-
288
- 在 MCP 配置的 `env` 字段中设置以下变量:
289
-
290
- **必需配置**:
291
- ```json
292
- {
293
- "OPENAI_API_KEY": "sk-...", // OpenAI API Key
294
- "DEFAULT_LLM_PROVIDER": "openai" // 使用 openai
295
- }
296
- ```
297
-
298
- 或使用 Anthropic:
299
- ```json
300
- {
301
- "ANTHROPIC_API_KEY": "sk-ant-...", // Anthropic API Key
302
- "DEFAULT_LLM_PROVIDER": "anthropic" // 使用 anthropic
303
- }
304
- ```
305
-
306
- **可选配置**:
307
- ```json
308
- {
309
- "PUPPETEER_HEADLESS": "false", // 是否无头模式
310
- "PUPPETEER_TIMEOUT": "30000", // 超时时间(毫秒)
311
- "ENABLE_CACHE": "true", // 启用缓存
312
- "LOG_LEVEL": "info", // 日志级别
313
- "OPENAI_HEADERS": "{\"proxy\":\"http://proxy.example.com:8080\"}" // OpenAI 自定义请求头(JSON格式)
314
- }
315
- ```
316
-
317
- **自定义请求头支持**(新增):
318
- 支持通过 `OPENAI_HEADERS` 环境变量配置自定义请求头,可用于:
319
- - 设置代理服务器
320
- - 添加自定义认证头
321
- - 配置请求路由
322
-
323
- 示例:
324
- ```json
325
- {
326
- "OPENAI_HEADERS": "{\"proxy\":\"http://proxy.example.com:8080\",\"X-Custom-Header\":\"value\"}"
327
- }
328
- ```
329
-
330
- ### 启动使用
331
-
332
- 重启 Claude Desktop,现在可以使用自然语言调用 JSHook 的所有工具了!
333
-
334
- ```
335
- 你:帮我分析 https://example.com 的加密算法
336
-
337
- Claude:
338
- 1. 启动浏览器并注入反检测脚本
339
- 2. 访问目标网站
340
- 3. 获取所有脚本,查找加密相关代码
341
- 4. 设置断点拦截加密函数调用
342
- 5. 分析加密逻辑...
343
- ```
344
-
345
- ---
346
-
347
- ## 典型工作流
348
-
349
- ### 场景 1: 分析加密算法
350
-
351
- ```
352
- 用户:帮我分析 https://api.example.com 的签名算法
353
-
354
- AI 自动执行:
355
- 1. browser_launch() + stealth_inject()
356
- 2. network_enable() + debugger_enable()
357
- 3. page_navigate("https://api.example.com")
358
- 4. get_all_scripts() → 找到可疑脚本
359
- 5. xhr_breakpoint_set(urlPattern="*/api/*") → 拦截 API 请求
360
- 6. watch_add("window.signParams") 监控签名参数
361
- 7. 触发请求 → debugger_wait_for_paused()
362
- 8. 分析调用栈和变量 → 定位签名算法
363
- ```
364
-
365
- ### 场景 2: 验证码自动检测
366
-
367
- ```
368
- 用户:访问 https://login.example.com 并告诉我是否有验证码
369
-
370
- AI 自动执行:
371
- 1. browser_launch()
372
- 2. page_navigate("https://login.example.com")
373
- 3. captcha_detect() → AI 视觉识别
374
- → 返回: { detected: true, type: "slider", vendor: "geetest" }
375
- 4. captcha_wait(timeout=300000) → 等待用户完成
376
- ```
377
-
378
- ### 场景 3: Hook API 调用
379
-
380
- ```
381
- 用户:监控所有 Fetch 请求,记录 URL 和参数
382
-
383
- AI 自动执行:
384
- 1. ai_hook_generate({
385
- description: "监控所有 Fetch 请求",
386
- target: { type: "api", name: "fetch" },
387
- behavior: { captureArgs: true, captureReturn: true }
388
- })
389
- 2. ai_hook_inject(method="evaluateOnNewDocument")
390
- 3. page_navigate("https://target.com")
391
- 4. 用户操作页面...
392
- 5. ai_hook_get_data() → 获取所有捕获的请求
393
- ```
394
-
395
- ---
396
-
397
- ## 项目结构
398
-
399
- ```
400
- jshook-reverse-tool/
401
- ├── src/
402
- │ ├── index.ts # MCP 服务器入口
403
- │ ├── server/
404
- │ │ ├── MCPServer.ts # 主服务器类(使用 McpServer API)
405
- │ │ ├── *ToolDefinitions.ts # 工具定义
406
- │ │ └── *ToolHandlers.ts # 工具实现
407
- │ ├── modules/ # 核心模块
408
- │ │ ├── collector/ # 浏览器自动化
409
- │ │ ├── debugger/ # 调试器
410
- │ │ ├── hook/ # Hook 管理
411
- │ │ ├── crypto/ # 加密检测
412
- │ │ └── captcha/ # 验证码识别
413
- │ ├── services/
414
- │ │ └── LLMService.ts # AI 服务封装(支持自定义请求头)
415
- │ ├── types/
416
- │ │ └── index.ts # 核心类型定义
417
- │ └── utils/ # 工具函数
418
- │ ├── config.ts # 配置管理(含 parseHeadersEnv)
419
- │ ├── TokenBudgetManager.ts # Token 预算管理
420
- │ └── UnifiedCacheManager.ts # 统一缓存管理
421
- ├── docs/ # 文档
422
- │ ├── MCP功能介绍.md # 完整功能文档
423
- │ ├── 技术文档.md # 技术实现细节
424
- │ └── 浏览器逆向实战教程.md # 实战案例
425
- ├── test/ # 测试用例
426
- ├── CLAUDE.md # Claude Code 项目文档
427
- ├── bun.lock # Bun 依赖锁定文件
428
- └── package.json
429
- ```
430
-
431
- ---
432
-
433
- ## 开发命令
434
-
435
- ```bash
436
- # 开发模式(自动重启)
437
- npm run dev
438
-
439
- # 构建项目
440
- npm run build
441
-
442
- # 运行测试
443
- npm test
444
-
445
- # 代码检查
446
- npm run lint
447
-
448
- # 格式化代码
449
- npm run format
450
-
451
- # 完整检查(lint + build + verify)
452
- npm run check
453
- ```
454
-
455
- ---
456
-
457
- ## 文档
458
-
459
- - 📘 [MCP 功能介绍](./docs/MCP功能介绍.md) - 80+ 工具完整说明
460
- - 📗 [浏览器逆向实战教程](./docs/浏览器逆向实战教程.md) - 实战案例
461
-
462
- ---
463
-
464
- ## 常见问题
465
-
466
- ### Q: 网络监控没有捕获到请求?
467
-
468
- **A**: 必须在 `page_navigate` **前**调用 `network_enable()`,或使用:
469
- ```javascript
470
- page_navigate(url="...", enableNetworkMonitoring=true)
471
- ```
472
-
473
- ### Q: 验证码检测失败?
474
-
475
- **A**: 确保使用支持 Vision API 的模型(GPT-4o、Claude 3.5 Sonnet)。如果使用不支持视觉的模型(如 DeepSeek),会返回截图让你手动分析。
476
-
477
- ### Q: Token 用完了怎么办?
478
-
479
- **A**:
480
- ```javascript
481
- manual_token_cleanup() // 清理 Token
482
- smart_cache_cleanup() // 智能清理缓存
483
- clear_all_caches() // 完全重置(慎用)
484
- ```
485
-
486
- ### Q: 如何跳过第三方库代码?
487
-
488
- **A**:
489
- ```javascript
490
- blackbox_add_common() // 一键屏蔽常见库
491
- // 或手动添加
492
- blackbox_add(urlPattern="*jquery*")
493
- ```
494
-
495
- ---
496
-
497
- ## 安全与法律
498
-
499
- JSHook 是一个**合法的逆向工程和安全研究工具**。
500
-
501
- ### ✅ 合法使用场景
502
-
503
- - 渗透测试授权项目
504
- - 安全研究和漏洞分析
505
- - CTF 竞赛和教育培训
506
- - 自己网站的性能优化
507
- - 爬虫开发和调试
508
-
509
- ### ❌ 禁止用途
510
-
511
- - 未授权的攻击和破解
512
- - 大规模爬取他人数据
513
- - 绕过付费墙和版权保护
514
- - DoS 攻击和供应链投毒
515
-
516
- **使用本工具即表示你理解并遵守相关法律法规。**
517
-
518
- ---
519
-
520
- ## 技术栈
521
-
522
- - **运行时**: Node.js 18+, TypeScript 5.0+
523
- - **浏览器自动化**: Puppeteer, Chrome DevTools Protocol
524
- - **AI 集成**: OpenAI API, Anthropic API
525
- - **MCP 协议**: @modelcontextprotocol/sdk
526
- - **AST 处理**: @babel/parser, @babel/traverse
527
- - **测试**: Jest
528
-
529
- ---
530
-
531
- ## 贡献
532
-
533
- 欢迎贡献代码、报告问题或提出建议!
534
-
535
- 1. Fork 本仓库
536
- 2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
537
- 3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
538
- 4. 推送到分支 (`git push origin feature/AmazingFeature`)
539
- 5. 打开 Pull Request
540
-
541
- ---
542
-
543
- ## 许可证
544
-
545
- 本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件
546
-
547
- ---
548
-
549
- ## 致谢
550
-
551
- - [Puppeteer](https://github.com/puppeteer/puppeteer) - 浏览器自动化
552
- - [Chrome DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/) - 调试协议
553
- - [Model Context Protocol](https://modelcontextprotocol.io/) - AI 工具协议
554
- - [Babel](https://babeljs.io/) - JavaScript 编译器
555
-
556
- ---
557
-
558
- <div align="center">
559
-
560
- **如果这个项目对你有帮助,请给一个 ⭐ Star!**
561
-
562
- Made with ❤️ by op要喝op果奶
563
-
564
- </div>
1
+ # JSHook Reverse Tool
2
+
3
+ <div align="center">
4
+
5
+ ** AI-Powered JavaScript Reverse Engineering Tool**
6
+
7
+ �?AI 助手成为你的浏览器逆向专家 | Let AI be your browser reverse engineering expert
8
+
9
+ [![npm version](https://img.shields.io/npm/v/%40ai-jshook%2Fmcp.svg)](https://www.npmjs.com/package/@ai-jshook/mcp)
10
+ [![npm downloads](https://img.shields.io/npm/dm/%40ai-jshook%2Fmcp.svg)](https://www.npmjs.com/package/@ai-jshook/mcp)
11
+ [![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io/servers/io.github.ai-jshook.mcp)
12
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
13
+ [![Node Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)
14
+ [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue)](https://www.typescriptlang.org/)
15
+ [![MCP](https://img.shields.io/badge/MCP-Protocol-orange)](https://modelcontextprotocol.io/)
16
+
17
+ [快速开始](#快速开�? �?[核心功能](#核心功能) �?[使用场景](#使用场景) �?[文档](#文档)
18
+
19
+ </div>
20
+
21
+ ---
22
+
23
+ ## �?一键安�?
24
+ ### �?npm 安装
25
+
26
+ ```bash
27
+ # 使用 npx(无需安装�?npx -y @ai-jshook/mcp
28
+
29
+ # 或全局安装
30
+ npm install -g @ai-jshook/mcp
31
+ ```
32
+
33
+ ### �?MCP Registry 安装(推荐)
34
+
35
+ 本工具已发布�?[MCP 官方注册表](https://registry.modelcontextprotocol.io/servers/io.github.ai-jshook.mcp),支�?Claude Desktop �?MCP 客户端直接发现和安装�?
36
+ 在支�?MCP Registry 的客户端中搜�?`ai-jshook-mcp` 即可找到并安装�?
37
+ 配置 Claude Desktop 后即可使�?80+ 专业逆向工具 �?[查看配置教程](#快速开�?
38
+
39
+ ---
40
+
41
+ ## 什么是 JSHook�?
42
+ JSHook 是一个基�?**MCP (Model Context Protocol)** �?JavaScript 逆向工程工具,通过 **80+ 个专业工�?*,让 Claude、ChatGPT �?AI 助手能够自动化完成复杂的网页分析、调试和逆向任务�?
43
+ ### 为什么选择 JSHook�?
44
+ - **AI 原生设计** - 专为 AI 助手优化,自然语言即可操作
45
+ - **反检测能�?* - 集成 2024-2025 最新反爬虫技�?- **深度调试** - Chrome DevTools Protocol 完整集成
46
+ - **网络拦截** - 捕获所�?HTTP 请求/响应
47
+ - **智能 Hook** - AI 自动生成 Hook 代码
48
+ - **验证码识�?* - AI 视觉识别各类验证�?
49
+ ---
50
+
51
+ ## 核心功能
52
+
53
+ ### 1. 浏览器自动化 (35 个工�?
54
+
55
+ 完整的浏览器控制能力,从页面导航�?DOM 操作,从截图到设备模拟�?
56
+ ```javascript
57
+ // 示例:自动化登录流程
58
+ browser_launch()
59
+ stealth_inject() // 注入反检测脚�?page_navigate(url="https://example.com/login")
60
+ page_type(selector="#username", text="user@example.com")
61
+ page_type(selector="#password", text="********")
62
+ page_click(selector="#loginBtn")
63
+ ```
64
+
65
+ **亮点功能**:
66
+ - �?2024-2025 最新反检测技术(隐藏 webdriver、Canvas指纹处理�?- �?AI 视觉验证码识别(滑块/图形/reCAPTCHA�?- �?智能等待和自动重�?- �?移动设备模拟
67
+
68
+ ### 2. 专业调试�?(38 个工�?
69
+
70
+ 基于 Chrome DevTools Protocol,提�?IDE 级别的调试能力�?
71
+ ```javascript
72
+ // 示例:调试加密算�?debugger_enable()
73
+
74
+ // 在所有加密API调用处暂�?xhr_breakpoint_set(urlPattern="*/api/sign*")
75
+ event_breakpoint_set(eventName="fetch")
76
+
77
+ // 监控关键变量
78
+ watch_add(expression="window.crypto_params", name="加密参数")
79
+
80
+ // 等待断点命中
81
+ debugger_wait_for_paused()
82
+ get_call_stack() // 查看调用�?watch_evaluate_all() // 查看所有监控变�?```
83
+
84
+ **亮点功能**:
85
+ - �?代码断点、条件断点、异常断�?- �?XHR/Fetch 断点(拦截网络请求)
86
+ - �?事件断点(点击、定时器、WebSocket�?- �?Watch 表达式、调用栈分析
87
+ - �?Blackboxing(屏蔽第三方库)
88
+ - �?调试会话保存/加载
89
+
90
+ ### 3. 网络监控 (6 个工�?
91
+
92
+ 捕获和分析所�?HTTP 流量,支持请求过滤和响应解析�?
93
+ ```javascript
94
+ // 示例:分�?API 请求
95
+ network_enable()
96
+ page_navigate(url="https://api.example.com")
97
+
98
+ // 过滤包含 "api" 的请�?network_get_requests(url="api", method="POST")
99
+
100
+ // 查看响应�?network_get_response_body(requestId="xxx")
101
+
102
+ // 统计分析
103
+ network_get_stats()
104
+ ```
105
+
106
+ **亮点功能**:
107
+ - �?捕获请求头、POST 数据、响应体
108
+ - �?智能过滤(URL、方法、类型)
109
+ - �?统计分析(请求数、失败率、耗时�?
110
+ ### 4. AI Hook 生成�?(7 个工�?
111
+
112
+ 用自然语言描述需求,AI 自动生成专业�?Hook 代码�?
113
+ ```javascript
114
+ // 示例:Hook Fetch API
115
+ ai_hook_generate({
116
+ description: "监控所�?API 请求,记�?URL 和参�?,
117
+ target: { type: "api", name: "fetch" },
118
+ behavior: {
119
+ captureArgs: true,
120
+ captureReturn: true,
121
+ logToConsole: true
122
+ },
123
+ condition: {
124
+ urlPattern: ".*api.*"
125
+ }
126
+ })
127
+
128
+ // 注入 Hook(必须在页面加载前)
129
+ ai_hook_inject(hookId="fetch-hook", method="evaluateOnNewDocument")
130
+
131
+ // 获取捕获的数�?ai_hook_get_data(hookId="fetch-hook")
132
+ ```
133
+
134
+ **支持�?Hook 类型**:
135
+ - 🎯 函数 Hook(`btoa`, `atob`, `eval`�?- 🎯 API Hook(`fetch`, `XMLHttpRequest`, `WebSocket`�?- 🎯 对象方法(`crypto.subtle.encrypt`�?- 🎯 属性拦截、事件监�?
136
+ ### 5. 性能分析 (4 个工�?
137
+
138
+ Web Vitals 指标、代码覆盖率、内存快照�?
139
+ ```javascript
140
+ performance_get_metrics(includeTimeline=true)
141
+ performance_start_coverage() // 启动覆盖率收�?// ... 操作页面 ...
142
+ performance_stop_coverage() // 获取未使用的代码
143
+ performance_take_heap_snapshot() // 内存分析
144
+ ```
145
+
146
+ ### 6. 缓存与预算管�?(6 个工�?
147
+
148
+ 智能管理 Token 预算和缓存,防止上下文溢出�?
149
+ ```javascript
150
+ get_token_budget_stats() // 查看 Token 使用情况
151
+ get_cache_stats() // 查看缓存统计
152
+
153
+ // Token 使用�?> 80% �?manual_token_cleanup() // 清理 Token
154
+ smart_cache_cleanup() // 智能清理缓存
155
+ ```
156
+
157
+ ---
158
+
159
+ ## 使用场景
160
+
161
+ ### 🔓 网页逆向
162
+
163
+ - 分析混淆加密�?JavaScript 代码
164
+ - 定位加密算法和签名生成逻辑
165
+ - 提取 API 请求参数
166
+
167
+ ### 🕷�?爬虫开�?
168
+ - 突破反爬虫检测(webdriver、Canvas指纹�?- 自动处理验证码(滑块/图形/reCAPTCHA�?- 捕获动态加载数�?
169
+ ### 🛡�?安全测试
170
+
171
+ - 漏洞挖掘和渗透测�?- XSS/CSRF 检�?- API 安全分析
172
+
173
+ ### �?性能优化
174
+
175
+ - 识别无用代码(代码覆盖率�?- 分析加载性能(Web Vitals�?- 内存泄漏检�?
176
+ ---
177
+
178
+ ## 快速开�?
179
+ ### 环境要求
180
+
181
+ - **Node.js**: >= 18.0.0
182
+ - **操作系统**: Windows / macOS / Linux
183
+ - **LLM API**: OpenAI �?Anthropic API Key
184
+
185
+ ### 安装方式
186
+
187
+ #### 方式一:直接使�?npx(推荐)�?
188
+ 无需安装,直接配置即可使用。编�?Claude Desktop 配置文件 `claude_desktop_config.json`:
189
+
190
+ ```json
191
+ {
192
+ "mcpServers": {
193
+ "jshook": {
194
+ "command": "npx",
195
+ "args": ["-y", "@ai-jshook/mcp"],
196
+ "env": {
197
+ "OPENAI_API_KEY": "sk-...",
198
+ "DEFAULT_LLM_PROVIDER": "openai"
199
+ }
200
+ }
201
+ }
202
+ }
203
+ ```
204
+
205
+ #### 方式二:全局安装
206
+
207
+ ```bash
208
+ npm install -g @ai-jshook/mcp
209
+ ```
210
+
211
+ 配置文件�?```json
212
+ {
213
+ "mcpServers": {
214
+ "jshook": {
215
+ "command": "ai-jshook-mcp",
216
+ "env": {
217
+ "OPENAI_API_KEY": "sk-...",
218
+ "DEFAULT_LLM_PROVIDER": "openai"
219
+ }
220
+ }
221
+ }
222
+ }
223
+ ```
224
+
225
+ #### 方式三:从源码安装(开发者)
226
+
227
+ ```bash
228
+ git clone https://github.com/715494637/jshook-reverse-tool.git
229
+ cd jshook-reverse-tool
230
+ npm install
231
+ npm run build
232
+ ```
233
+
234
+ 配置文件�?```json
235
+ {
236
+ "mcpServers": {
237
+ "jshook": {
238
+ "command": "node",
239
+ "args": ["C:/path/to/jshook/dist/index.js"],
240
+ "env": {
241
+ "OPENAI_API_KEY": "sk-...",
242
+ "DEFAULT_LLM_PROVIDER": "openai"
243
+ }
244
+ }
245
+ }
246
+ }
247
+ ```
248
+
249
+ ### 环境变量配置
250
+
251
+ �?MCP 配置�?`env` 字段中设置以下变量:
252
+
253
+ **必需配置**:
254
+ ```json
255
+ {
256
+ "OPENAI_API_KEY": "sk-...", // OpenAI API Key
257
+ "DEFAULT_LLM_PROVIDER": "openai" // 使用 openai
258
+ }
259
+ ```
260
+
261
+ 或使�?Anthropic:
262
+ ```json
263
+ {
264
+ "ANTHROPIC_API_KEY": "sk-ant-...", // Anthropic API Key
265
+ "DEFAULT_LLM_PROVIDER": "anthropic" // 使用 anthropic
266
+ }
267
+ ```
268
+
269
+ **可选配�?*:
270
+ ```json
271
+ {
272
+ "PUPPETEER_HEADLESS": "false", // 是否无头模式
273
+ "PUPPETEER_TIMEOUT": "30000", // 超时时间(毫秒)
274
+ "ENABLE_CACHE": "true", // 启用缓存
275
+ "LOG_LEVEL": "info" // 日志级别
276
+ }
277
+ ```
278
+
279
+ ### 启动使用
280
+
281
+ 重启 Claude Desktop,现在可以使用自然语言调用 JSHook 的所有工具了�?
282
+ ```
283
+ 你:帮我分析 https://example.com 的加密算�?
284
+ Claude�?1. 启动浏览器并注入反检测脚�?2. 访问目标网站
285
+ 3. 获取所有脚本,查找加密相关代码
286
+ 4. 设置断点拦截加密函数调用
287
+ 5. 分析加密逻辑...
288
+ ```
289
+
290
+ ---
291
+
292
+ ## 典型工作�?
293
+ ### 场景 1: 分析加密算法
294
+
295
+ ```
296
+ 用户:帮我分�?https://api.example.com 的签名算�?
297
+ AI 自动执行�?1. browser_launch() + stealth_inject()
298
+ 2. network_enable() + debugger_enable()
299
+ 3. page_navigate("https://api.example.com")
300
+ 4. get_all_scripts() �?找到可疑脚本
301
+ 5. xhr_breakpoint_set(urlPattern="*/api/*") �?拦截 API 请求
302
+ 6. watch_add("window.signParams") �?监控签名参数
303
+ 7. 触发请求 �?debugger_wait_for_paused()
304
+ 8. 分析调用栈和变量 �?定位签名算法
305
+ ```
306
+
307
+ ### 场景 2: 验证码自动检�?
308
+ ```
309
+ 用户:访�?https://login.example.com 并告诉我是否有验证码
310
+
311
+ AI 自动执行�?1. browser_launch()
312
+ 2. page_navigate("https://login.example.com")
313
+ 3. captcha_detect() �?AI 视觉识别
314
+ �?返回: { detected: true, type: "slider", vendor: "geetest" }
315
+ 4. captcha_wait(timeout=300000) �?等待用户完成
316
+ ```
317
+
318
+ ### 场景 3: Hook API 调用
319
+
320
+ ```
321
+ 用户:监控所�?Fetch 请求,记�?URL 和参�?
322
+ AI 自动执行�?1. ai_hook_generate({
323
+ description: "监控所�?Fetch 请求",
324
+ target: { type: "api", name: "fetch" },
325
+ behavior: { captureArgs: true, captureReturn: true }
326
+ })
327
+ 2. ai_hook_inject(method="evaluateOnNewDocument")
328
+ 3. page_navigate("https://target.com")
329
+ 4. 用户操作页面...
330
+ 5. ai_hook_get_data() �?获取所有捕获的请求
331
+ ```
332
+
333
+ ---
334
+
335
+ ## 项目结构
336
+
337
+ ```
338
+ jshook-reverse-tool/
339
+ ├── src/
340
+ �? ├── index.ts # MCP 服务器入�?�? ├── server/
341
+ �? �? ├── MCPServer.ts # 主服务器�?�? �? ├── *ToolDefinitions.ts # 工具定义
342
+ �? �? └── *ToolHandlers.ts # 工具实现
343
+ �? ├── modules/ # 核心模块
344
+ �? �? ├── collector/ # 浏览器自动化
345
+ �? �? ├── debugger/ # 调试�?�? �? ├── hook/ # Hook 管理
346
+ �? �? ├── crypto/ # 加密检�?�? �? └── captcha/ # 验证码识�?�? ├── services/
347
+ �? �? └── LLMService.ts # AI 服务封装
348
+ �? └── utils/ # 工具函数
349
+ ├── docs/ # 文档
350
+ �? ├── MCP功能介绍.md # 完整功能文档
351
+ �? ├── 技术文�?md # 技术实现细�?�? └── 浏览器逆向实战教程.md # 实战案例
352
+ ├── test/ # 测试用例
353
+ └── package.json
354
+ ```
355
+
356
+ ---
357
+
358
+ ## 开发命�?
359
+ ```bash
360
+ # 开发模式(自动重启�?npm run dev
361
+
362
+ # 构建项目
363
+ npm run build
364
+
365
+ # 运行测试
366
+ npm test
367
+
368
+ # 代码检�?npm run lint
369
+
370
+ # 格式化代�?npm run format
371
+
372
+ # 完整检查(lint + build + verify�?npm run check
373
+ ```
374
+
375
+ ---
376
+
377
+ ## 文档
378
+
379
+ - 📘 [MCP 功能介绍](./docs/MCP功能介绍.md) - 80+ 工具完整说明
380
+ - 📗 [浏览器逆向实战教程](./docs/浏览器逆向实战教程.md) - 实战案例
381
+
382
+ ---
383
+
384
+ ## 常见问题
385
+
386
+ ### Q: 网络监控没有捕获到请求?
387
+
388
+ **A**: 必须�?`page_navigate` **�?*调用 `network_enable()`,或使用�?```javascript
389
+ page_navigate(url="...", enableNetworkMonitoring=true)
390
+ ```
391
+
392
+ ### Q: 验证码检测失败?
393
+
394
+ **A**: 确保使用支持 Vision API 的模型(GPT-4o、Claude 3.5 Sonnet)。如果使用不支持视觉的模型(�?DeepSeek),会返回截图让你手动分析�?
395
+ ### Q: Token 用完了怎么办?
396
+
397
+ **A**:
398
+ ```javascript
399
+ manual_token_cleanup() // 清理 Token
400
+ smart_cache_cleanup() // 智能清理缓存
401
+ clear_all_caches() // 完全重置(慎用)
402
+ ```
403
+
404
+ ### Q: 如何跳过第三方库代码�?
405
+ **A**:
406
+ ```javascript
407
+ blackbox_add_common() // 一键屏蔽常见库
408
+ // 或手动添�?blackbox_add(urlPattern="*jquery*")
409
+ ```
410
+
411
+ ---
412
+
413
+ ## 安全与法�?
414
+ JSHook 是一�?*合法的逆向工程和安全研究工�?*�?
415
+ ### �?合法使用场景
416
+
417
+ - 渗透测试授权项�?- 安全研究和漏洞分�?- CTF 竞赛和教育培�?- 自己网站的性能优化
418
+ - 爬虫开发和调试
419
+
420
+ ### �?禁止用�?
421
+ - 未授权的攻击和破�?- 大规模爬取他人数�?- 绕过付费墙和版权保护
422
+ - DoS 攻击和供应链投毒
423
+
424
+ **使用本工具即表示你理解并遵守相关法律法规�?*
425
+
426
+ ---
427
+
428
+ ## 技术栈
429
+
430
+ - **运行�?*: Node.js 18+, TypeScript 5.0+
431
+ - **浏览器自动化**: Puppeteer, Chrome DevTools Protocol
432
+ - **AI 集成**: OpenAI API, Anthropic API
433
+ - **MCP 协议**: @modelcontextprotocol/sdk
434
+ - **AST 处理**: @babel/parser, @babel/traverse
435
+ - **测试**: Jest
436
+
437
+ ---
438
+
439
+ ## 贡献
440
+
441
+ 欢迎贡献代码、报告问题或提出建议�?
442
+
443
+
444
+
445
+ 1. Fork 本仓�?2. 创建特性分�?(`git checkout -b feature/AmazingFeature`)
446
+ 3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
447
+ 4. 推送到分支 (`git push origin feature/AmazingFeature`)
448
+ 5. 打开 Pull Request
449
+
450
+ ---
451
+
452
+ ## 许可�?
453
+ 本项目采�?MIT 许可�?- 详见 [LICENSE](LICENSE) 文件
454
+
455
+ ---
456
+
457
+ ## 致谢
458
+
459
+ - [Puppeteer](https://github.com/puppeteer/puppeteer) - 浏览器自动化
460
+ - [Chrome DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/) - 调试协议
461
+ - [Model Context Protocol](https://modelcontextprotocol.io/) - AI 工具协议
462
+ - [Babel](https://babeljs.io/) - JavaScript 编译�?
463
+ ---
464
+
465
+ <div align="center">
466
+
467
+ **如果这个项目对你有帮助,请给一�?�?Star�?*
468
+
469
+ Made with ❤️ by JSHook Team
470
+
471
+ </div>