revenant (Dannyisbad)

亡魂

允许Claude Code控制本地IDA Pro实例的MCP服务器。HTTP 工具服务器在IDA内部运行，Revenant通过MCP将其桥接到Claude Code （stdio）。多实例感知——在不同端口上运行多个IDA服务器 并使用可选功能路由呼叫 target 参数。IDA侧服务器 绑定到 127.0.0.1 只有。

Claude Code  ->  MCP (stdio)  ->  revenant-mcp  ->  HTTP (localhost)  ->  IDA Pro

需求

• Python 3.10+
• IDA Pro+IDAPython 9.x

安装（dev）

python -m pip install -U pip
python -m pip install -e .[dev]

快速入门

1） 启动IDA工具服务器（IDA内部）

在IDA中打开一个二进制文件，然后运行：

File -> Script file -> ida_server.py

这是一个运行的薄包装 scripts/ida_server.py.

2） 验证连接

revenant doctor

3） 运行Claude Code的MCP服务器

revenant-mcp --ida http://127.0.0.1:8765

在Claude Code MCP设置中，将服务器命令指向 revenant-mcp. 示例配置位于 examples/claude-code.mcp.json.

多实例路由

如果在不同端口上运行两个IDA实例，Revenant可以发现它们：

revenant discover

工具调用接受可选 target 参数（实例名称或端口）：

{ "ea": "0x140001000", "target": "8766" }

环境变量

REVENANT_IDA_URL （或遗产 IDA_RPC_URL)：默认IDA服务器URL。 REVENANT_AUTH_TOKEN （或遗产 IDA_RPC_TOKEN)：如果设置，IDA服务器 需要令牌（通过发送 Authorization: Bearer 或 X-Revenant-Token: ). REVENANT_INSTANCE_NAME / REVENANT_PORT: IDA脚本提示的默认值。

Revenant也加载 .env 从当前工作目录或 ~/.revenant/.env （键不会覆盖现有的环境变量）。

两者 revenant 和 revenant-mcp 接受 --token 以覆盖 环境。

回购布局

scripts/ida_server.py      IDA-side HTTP tool server (run inside IDA)
src/revenant/mcp/server.py  MCP server (run outside IDA, from Claude Code)
src/revenant/cli.py         Doctor/discovery CLI

许可证

麻省理工学院（见 LICENSE).