Ida MCP Bridge

ida_mcp_bridge

最少的CLI配套使用 ida-pro-mcp 从shell脚本、轻量级代理和通用AI工作流。

此项目不能替代 ida-pro-mcp。对于需要简单CLI而不是完整MCP客户端的情况，它是一个瘦桥。

当它有帮助时

• 从终端调用IDA MCP工具
• 脚本可重复的逆向工程操作
• 通过stdin/stdout、文件和shell命令将通用AI工作流连接到IDA

典型设置：

• IDA Pro+ ida-pro-mcp 在相同的环境中运行
• ida_mcp_bridge 无论你的shell或AI工具在哪里运行，它都会运行
• 网桥连接到由以下组件暴露的SSE端点 ida-pro-mcp

快速开始

python bridge.py --url http://127.0.0.1:8744/sse check
python bridge.py --url http://127.0.0.1:8744/sse tools
python bridge.py --url http://127.0.0.1:8744/sse call get_metadata --extract structured

对于Windows PowerShell，首选 --arguments-file 通过内联JSON。

python bridge.py --url http://127.0.0.1:8744/sse call decompile_function --arguments-file examples/decompile_function.json

主要命令

• check：验证连接并获取当前元数据
• tools：列出MCP服务器公开的工具
• call：按名称调用任何工具
• clean：删除 .cache/ 以及其他临时性的本地文物

缓存

• 缓存是通过以下方式选择加入的 --cache
• 默认缓存目录： .cache/
• git忽略缓存文件

示例：

python bridge.py --url http://127.0.0.1:8744/sse check --cache
python bridge.py --url http://127.0.0.1:8744/sse call get_metadata --cache

VM注释

如果IDA在VM内运行， 127.0.0.1 只能从同一VM内部工作。

• ida-pro-mcp --transport 使用传输地址，例如 http://0.0.0.0:8744
• bridge.py --url 使用可访问的SSE地址，通常 http://:8744/sse

不要从主机使用这些：

• http://0.0.0.0:8744/sse
• http://127.0.0.1:8744/sse 除非网桥在同一VM内运行

文件

• README.zh-CN.md：中文自述
• 安全.md：安全说明

备注

• PowerShell JSON转义可能很尴尬； --arguments-file 和 --arguments-stdin 通常更可靠
• --extract content-text 仅当响应实际包含文本内容条目时才有效
• 此存储库有意忽略临时分析工件和缓存文件