hgxszhj/https-github.com-zhaoxuya520-reverse-skill / skills/ida-reverse
ida-reverse
VerifiedIDA Pro 逆向分析辅助技能。当用户提到逆向、反编译、分析二进制/PE/ELF/APK/DLL/SO、破解、找密码、漏洞分析、病毒分析、firmware 固件分析,或需要分析 exe/dll/so/elf/macho/sys 等文件时,务必使用此技能。 Ensure to use this skill when the user wants to analyze any binary file, regardless of whether they explicitly mention "IDA" or "reverse engineering". This includes requests like "看看这个exe", "分析这个dll", "帮我破解", "找一下密码", "这个软件怎么注册", etc. Use the bundled scripts (scripts/start.ps1, scripts/open.ps1) for deterministic server management and file opening — do NOT write ad-hoc PowerShell commands for these operations.
| File | Kind | Size |
|---|---|---|
| LOCAL-SETUP.md | markdown | 3.3 KB |
| SKILL.md | skill md | 19.6 KB |
| references/ida-mcp-cheatsheet.md | markdown | 11.0 KB |
| scripts/IdaOpenHelpers.ps1 | script | 3.7 KB |
| scripts/install-autostart.ps1 | script | 2.4 KB |
| scripts/open.ps1 | script | 12.9 KB |
| scripts/recover.ps1 | script | 458 B |
| scripts/run-supervisor.py | script | 4.2 KB |
| scripts/start-gui.ps1 | script | 3.8 KB |
| scripts/start.ps1 | script | 18.4 KB |
| scripts/watchdog.ps1 | script | 4.6 KB |
LOCAL-SETUP.md
View on GitHub# IDA ↔ reverse-skill 对接(可移植)
本页是通用步骤,不含某台机器的绝对路径。本机就绪报告留在仓库根目录的 `LOCAL-READINESS.md`(已 gitignore)。
## 目标形态
| 项 | 约定 |
|----|------|
| IDA 安装目录 | 环境变量 `IDADIR`(目录内有 `ida.exe` 或 `ida.dll`) |
| HTTP MCP | `http://127.0.0.1:13337/mcp` |
| 客户端服务器名 | 只留 **`idapro`**(不要同时注册 `ida-pro-mcp`) |
| 启动 | `scripts/start.ps1`(`--unsafe`,无 `?ext=dbg`) |
| 开库 | 大文件优先 `scripts/open.ps1`,不要经部分客户端直调 `idb_open` |
两个 MCP 名字指向同一 13337 会把工具注册两遍,并和 idalib worker 抢端口。
## 安装
```powershell
setx IDADIR "<你的 IDA 安装目录>"
# 必须用 mrexodia/ida-pro-mcp,不要装 PyPI 的 ida-mcp
python -m pip install "git+https://github.com/mrexodia/ida-pro-mcp.git"
# 激活 idalib(路径按本机 IDA 调整)
python "<IDADIR>\idalib\python\py-activate-idalib.py" -d "<IDADIR>"
# 装插件 + 客户端配置
python -m ida_pro_mcp --install --transport streamable-http --scope global
```
## 启动与保活
`type: http` 的 MCP 条目不会代为拉起进程。13337 没监听时,客户端全部报 error。
| 脚本 | 作用 |
|------|------|
| `scripts/start.ps1` | 健康则 `OK:<n>:reuse` 并刷新 last-healthy;端口在听但 RPC 超时视为忙,不杀;只在无人监听、缺 `py_eval`、或 tools/list 连续失败超过 3 分钟(且无 `opening.lock`)时替换 managed supervisor;永不杀 `ida.exe` |
| `scripts/watchdog.ps1` | 每分钟巡检;健康 reuse;GUI / `open.ps1` 开库锁 / last-healthy 未满 3 分钟 → reuse;**tools/list 连续失败超过 3 分钟才 `-Force`** |
| `scripts/recover.ps1` | 立刻 `-Force` 重启 supervisor(不杀 `ida.exe`)。HTTP 客户端把 `idapro` 标成 error 时用这个 |
| `scripts/install-autostart.ps1` | 注册计划任务 `reverse-skill-ida-mcp`(登录 + 每分钟) |
| `scripts/start-gui.ps1` | idalib license 失败时开 GUI 插件 |
| `scripts/open.ps1` | HTTP 直调 `idb_open`,绕过部分客户端 schema 校验 |
日志:`%LOCALAPPDATA%\reverse-skill\ida-mcp\supervisor.log` 与 `watchdog.log`。
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File "skills\ida-reverse\scripts\start.ps1"
powershell -NoProfile -ExecutionPolicy Bypass -File "skills\ida-reverse\scripts\open.ps1" -Path "C:\path\to\target.exe" -TimeoutSeconds 600
powershell -NoProfile -ExecutionPolicy Bypass -File "skills\ida-reverse\scripts\install-autostart.ps1"
```
GUI 占用 13337 但一时没回包时,`start.ps1` 输出 `WARN:gui_busy` 并退出,避免把正在分析的 IDA 干掉。
## 客户端
全部指向 Streamable HTTP:`http://127.0.0.1:13337/mcp`,服务器名 `idapro`。
改配置后必须新开会话。Cursor 在启动时若端口未监听,事后把服务拉起来也**不会自动重连**,需要在 MCP 面板手动刷新。
## 已知注意点
1. System32 文件:`open.ps1` 会复制到临时路径(输出带 `(temp copy)`)
2. `idb_open` 勿经部分客户端 MCP 直调
3. `start.ps1` 优先 `python -m ida_pro_mcp.idalib_supervisor`,比 `.cmd` 包装更稳
4. 正式安装与桌面便携包并存时,以 `IDADIR` 为准
5. 不要加 `?ext=dbg`(默认不暴露调试器工具)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 469k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |