JSHook Reverse Tool

---

⚡ 一键安装

$3

``bash


使用 npx（无需安装）

npx jshook-reverse-tool

或全局安装

npm install -g jshook-reverse-tool
`

$3

本工具已发布到 MCP 官方注册表，支持 Claude Desktop 等 MCP 客户端直接发现和安装。

在支持 MCP Registry 的客户端中搜索 jshook-reverse-tool 即可找到并安装。

配置 Claude Desktop 后即可使用 80+ 专业逆向工具 → 查看配置教程

---

什么是 JSHook？

JSHook 是一个基于 MCP (Model Context Protocol) 的 JavaScript 逆向工程工具，通过 80+ 个专业工具，让 Claude、ChatGPT 等 AI 助手能够自动化完成复杂的网页分析、调试和逆向任务。

$3

- AI 原生设计 - 专为 AI 助手优化，自然语言即可操作
- 反检测能力 - 集成 2024-2025 最新反爬虫技术
- 深度调试 - Chrome DevTools Protocol 完整集成
- 网络拦截 - 捕获所有 HTTP 请求/响应
- 智能 Hook - AI 自动生成 Hook 代码
- 验证码识别 - AI 视觉识别各类验证码

---

核心功能

$3

完整的浏览器控制能力，从页面导航到 DOM 操作，从截图到设备模拟。

`javascript
// 示例：自动化登录流程
browser_launch()
stealth_inject() // 注入反检测脚本
page_navigate(url="https://example.com/login")
page_type(selector="#username", text="user@example.com")
page_type(selector="#password", text="**")
page_click(selector="#loginBtn")
`

亮点功能:
- ✅ 2024-2025 最新反检测技术（隐藏 webdriver、Canvas指纹处理）
- ✅ AI 视觉验证码识别（滑块/图形/reCAPTCHA）
- ✅ 智能等待和自动重试
- ✅ 移动设备模拟

$3

基于 Chrome DevTools Protocol，提供 IDE 级别的调试能力。

`javascript
// 示例：调试加密算法
debugger_enable()

// 在所有加密API调用处暂停
xhr_breakpoint_set(urlPattern="/api/sign")
event_breakpoint_set(eventName="fetch")

// 监控关键变量
watch_add(expression="window.crypto_params", name="加密参数")

// 等待断点命中
debugger_wait_for_paused()
get_call_stack() // 查看调用栈
watch_evaluate_all() // 查看所有监控变量
`

亮点功能:
- ✅ 代码断点、条件断点、异常断点
- ✅ XHR/Fetch 断点（拦截网络请求）
- ✅ 事件断点（点击、定时器、WebSocket）
- ✅ Watch 表达式、调用栈分析
- ✅ Blackboxing（屏蔽第三方库）
- ✅ 调试会话保存/加载

$3

捕获和分析所有 HTTP 流量，支持请求过滤和响应解析。

`javascript
// 示例：分析 API 请求
network_enable()
page_navigate(url="https://api.example.com")

// 过滤包含 "api" 的请求
network_get_requests(url="api", method="POST")

// 查看响应体
network_get_response_body(requestId="xxx")

// 统计分析
network_get_stats()
`

亮点功能:
- ✅ 捕获请求头、POST 数据、响应体
- ✅ 智能过滤（URL、方法、类型）
- ✅ 统计分析（请求数、失败率、耗时）

$3

用自然语言描述需求，AI 自动生成专业的 Hook 代码。

`javascript
// 示例：Hook Fetch API
ai_hook_generate({
description: "监控所有 API 请求，记录 URL 和参数",
target: { type: "api", name: "fetch" },
behavior: {
captureArgs: true,
captureReturn: true,
logToConsole: true
},
condition: {
urlPattern: ".api."
}
})

// 注入 Hook（必须在页面加载前）
ai_hook_inject(hookId="fetch-hook", method="evaluateOnNewDocument")

// 获取捕获的数据
ai_hook_get_data(hookId="fetch-hook")
`

支持的 Hook 类型:
- 🎯 函数 Hook（btoa, atob, eval）
- 🎯 API Hook（fetch, XMLHttpRequest, WebSocket）
- 🎯 对象方法（crypto.subtle.encrypt）
- 🎯 属性拦截、事件监听

$3

Web Vitals 指标、代码覆盖率、内存快照。

`javascript
performance_get_metrics(includeTimeline=true)
performance_start_coverage() // 启动覆盖率收集
// ... 操作页面 ...
performance_stop_coverage() // 获取未使用的代码
performance_take_heap_snapshot() // 内存分析
`

$3

智能管理 Token 预算和缓存，防止上下文溢出。

`javascript
get_token_budget_stats() // 查看 Token 使用情况
get_cache_stats() // 查看缓存统计

// Token 使用率 > 80% 时
manual_token_cleanup() // 清理 Token
smart_cache_cleanup() // 智能清理缓存
`

---

使用场景

$3

- 分析混淆加密的 JavaScript 代码
- 定位加密算法和签名生成逻辑
- 提取 API 请求参数

$3

- 突破反爬虫检测（webdriver、Canvas指纹）
- 自动处理验证码（滑块/图形/reCAPTCHA）
- 捕获动态加载数据

$3

- 漏洞挖掘和渗透测试
- XSS/CSRF 检测
- API 安全分析

$3

- 识别无用代码（代码覆盖率）
- 分析加载性能（Web Vitals）
- 内存泄漏检测

---

快速开始

$3

- Node.js: >= 18.0.0
- 操作系统: Windows / macOS / Linux
- LLM API: OpenAI 或 Anthropic API Key

$3

#### 方式一：直接使用 npx（推荐）⭐

无需安装，直接配置即可使用。编辑 Claude Desktop 配置文件 claude_desktop_config.json:

`json
{
"mcpServers": {
"jshook": {
"command": "npx",
"args": ["-y", "jshook-reverse-tool"],
"env": {
"OPENAI_API_KEY": "sk-...",
"DEFAULT_LLM_PROVIDER": "openai"
}
}
}
}
`

#### 方式二：全局安装

`bash
npm install -g jshook-reverse-tool
`

配置文件：
`json
{
"mcpServers": {
"jshook": {
"command": "jshook-reverse-tool",
"env": {
"OPENAI_API_KEY": "sk-...",
"DEFAULT_LLM_PROVIDER": "openai"
}
}
}
}
`

#### 方式三：从源码安装（开发者）

`bash
git clone https://github.com/wuji1/jshook-reverse-tool.git
cd jshook-reverse-tool
npm install
npm run build
`

配置文件：
`json
{
"mcpServers": {
"jshook": {
"command": "node",
"args": ["C:/path/to/jshook/dist/index.js"],
"env": {
"OPENAI_API_KEY": "sk-...",
"DEFAULT_LLM_PROVIDER": "openai"
}
}
}
}
`

$3

在 MCP 配置的 env 字段中设置以下变量：

必需配置:
`json
{
"OPENAI_API_KEY": "sk-...", // OpenAI API Key
"DEFAULT_LLM_PROVIDER": "openai" // 使用 openai
}
`

或使用 Anthropic:
`json
{
"ANTHROPIC_API_KEY": "sk-ant-...", // Anthropic API Key
"DEFAULT_LLM_PROVIDER": "anthropic" // 使用 anthropic
}
`

可选配置:
`json
{
"PUPPETEER_HEADLESS": "false", // 是否无头模式
"PUPPETEER_TIMEOUT": "30000", // 超时时间(毫秒)
"ENABLE_CACHE": "true", // 启用缓存
"LOG_LEVEL": "info" // 日志级别
}
`

$3

重启 Claude Desktop，现在可以使用自然语言调用 JSHook 的所有工具了！

`
你：帮我分析 https://example.com 的加密算法

Claude：
1. 启动浏览器并注入反检测脚本
2. 访问目标网站
3. 获取所有脚本，查找加密相关代码
4. 设置断点拦截加密函数调用
5. 分析加密逻辑...
`

---

典型工作流

$3

`
用户：帮我分析 https://api.example.com 的签名算法

AI 自动执行：
1. browser_launch() + stealth_inject()
2. network_enable() + debugger_enable()
3. page_navigate("https://api.example.com")
4. get_all_scripts() → 找到可疑脚本
5. xhr_breakpoint_set(urlPattern="/api/") → 拦截 API 请求
6. watch_add("window.signParams") → 监控签名参数
7. 触发请求 → debugger_wait_for_paused()
8. 分析调用栈和变量 → 定位签名算法
`

$3

`
用户：访问 https://login.example.com 并告诉我是否有验证码

AI 自动执行：
1. browser_launch()
2. page_navigate("https://login.example.com")
3. captcha_detect() → AI 视觉识别
→ 返回: { detected: true, type: "slider", vendor: "geetest" }
4. captcha_wait(timeout=300000) → 等待用户完成
`

$3

`
用户：监控所有 Fetch 请求，记录 URL 和参数

AI 自动执行：
1. ai_hook_generate({
description: "监控所有 Fetch 请求",
target: { type: "api", name: "fetch" },
behavior: { captureArgs: true, captureReturn: true }
})
2. ai_hook_inject(method="evaluateOnNewDocument")
3. page_navigate("https://target.com")
4. 用户操作页面...
5. ai_hook_get_data() → 获取所有捕获的请求
`

---

项目结构

`
jshook-reverse-tool/
├── src/
│ ├── index.ts # MCP 服务器入口
│ ├── server/
│ │ ├── MCPServer.ts # 主服务器类
│ │ ├── *ToolDefinitions.ts # 工具定义
│ │ └── *ToolHandlers.ts # 工具实现
│ ├── modules/ # 核心模块
│ │ ├── collector/ # 浏览器自动化
│ │ ├── debugger/ # 调试器
│ │ ├── hook/ # Hook 管理
│ │ ├── crypto/ # 加密检测
│ │ └── captcha/ # 验证码识别
│ ├── services/
│ │ └── LLMService.ts # AI 服务封装
│ └── utils/ # 工具函数
├── docs/ # 文档
│ ├── MCP功能介绍.md # 完整功能文档
│ ├── 技术文档.md # 技术实现细节
│ └── 浏览器逆向实战教程.md # 实战案例
├── test/ # 测试用例
└── package.json
`

---

开发命令

`bash


开发模式（自动重启）

npm run dev

构建项目

npm run build

运行测试

npm test

代码检查

npm run lint

格式化代码

npm run format

完整检查（lint + build + verify）

npm run check
`

---

文档

- 📘 MCP 功能介绍 - 80+ 工具完整说明
- 📗 浏览器逆向实战教程 - 实战案例

---

常见问题

$3

A: 必须在 page_navigate 前调用 network_enable()，或使用：
`javascript
page_navigate(url="...", enableNetworkMonitoring=true)
`

$3

A: 确保使用支持 Vision API 的模型（GPT-4o、Claude 3.5 Sonnet）。如果使用不支持视觉的模型（如 DeepSeek），会返回截图让你手动分析。

$3

A:
`javascript
manual_token_cleanup() // 清理 Token
smart_cache_cleanup() // 智能清理缓存
clear_all_caches() // 完全重置（慎用）
`

$3

A:
`javascript
blackbox_add_common() // 一键屏蔽常见库
// 或手动添加
blackbox_add(urlPattern="jquery")
`

---

安全与法律

JSHook 是一个合法的逆向工程和安全研究工具。

$3

- 渗透测试授权项目
- 安全研究和漏洞分析
- CTF 竞赛和教育培训
- 自己网站的性能优化
- 爬虫开发和调试

$3

- 未授权的攻击和破解
- 大规模爬取他人数据
- 绕过付费墙和版权保护
- DoS 攻击和供应链投毒

使用本工具即表示你理解并遵守相关法律法规。

---

技术栈

- 运行时: Node.js 18+, TypeScript 5.0+
- 浏览器自动化: Puppeteer, Chrome DevTools Protocol
- AI 集成: OpenAI API, Anthropic API
- MCP 协议: @modelcontextprotocol/sdk
- AST 处理: @babel/parser, @babel/traverse
- 测试: Jest

---

贡献

欢迎贡献代码、报告问题或提出建议！


1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature`)
5. 打开 Pull Request

---

许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件

---

致谢

- Puppeteer - 浏览器自动化
- Chrome DevTools Protocol - 调试协议
- Model Context Protocol - AI 工具协议
- Babel - JavaScript 编译器

---