IDA Pro MCP Fusion

IDA Pro MCP Fusionconnects MCP-compatible coding agents to IDA Pro and turns a single connection into a practical reverse-engineering workspace. It combines live IDA analysis with a persistent SQLite index and a supervisor that can keep several binaries open in isolated headless workers.

Use it to decompile and disassemble functions, trace cross-references, query types, rename symbols, patch data, create signatures, inspect multiple samples, and reuse cached analysis without repeatedly walking IDA's single-threaded APIs.

Activate IDA's headless Python environment once:

# Windows — adjust the IDA version/path if needed uv run "C:\Program Files\IDA Professional 9.3\idalib\python\py-activate-idalib.py"

# macOS — adjust the IDA version/path if needed uv run "/Applications/IDA Professional 9.3.app/Contents/MacOS/idalib/python/py-activate-idalib.py"

The recommended setup runs the latest code directly from this repository:

idb_open( "C:/samples/target.exe", preferred_session_id="target", build_caches=True, init_hexrays=True, )

Every analysis call then names its database explicitly:

survey_binary(database="target") decompile("main", database="target") xrefs_to("WinMain", database="target") cache_callgraph_hotspots(limit=25, database="target")

- Your MCP client startsidalib-mcpover stdio or HTTP.
- The supervisor creates or adopts one worker per binary and enforces the worker limit.
- Tool calls include adatabasesession ID, so requests are routed to the correct IDB.
- IDA performs live decompilation and mutation work; cache tools serve indexed queries from the sidecar SQLite database.
- Workers remain discoverable on the host and clean themselves up after their idle TTL.

GUI databases can participate too.idb_opensupports four routing modes:

Open a small collection and keep every session available:

Management tools remain available so sessions can still be opened and inspected.

ida-pro-mcp --transport http://127.0.0.1:8744/sse

To install the GUI plugin and generate client configuration interactively:

python -m pip install https://github.com/rison1337/ida-pro-mcp-fusion/archive/refs/heads/main.zip ida-pro-mcp --install

Restart IDA and the MCP client after installation.

- The server binds to loopback by default. Do not expose it to an untrusted network.
- Mutating and arbitrary-Python tools are marked unsafe and are not enabled by default.
- py_eval,py_exec_file, debugger controls, and patching operations can execute code or permanently change an IDB. Enable them only for trusted clients and inputs.
- Analyze untrusted binaries inside the same isolation boundary you would use for manual malware analysis.

Enable unsafe worker tools only when the workflow requires them:

Installuvwithpython -m pip install uv, open a new terminal, and confirm withuvx --version.

Run Hex-Raysidapyswitch, select a Python 3.11+ installation, then activate idalib again withpy-activate-idalib.py.

Callidb_list()and pass the returnedsession_idasdatabase=. Paths and filenames are not accepted in place of a session ID.

Close an unused session withidb_close, raise--max-workers, or useclose_after_cache=Truefor corpus indexing.

Clone the repository and run the platform-independent test suite:

git clone https://github.com/rison1337/ida-pro-mcp-fusion.git cd ida-pro-mcp-fusion python -m pip install pytest jsonschema "mcp>=1.0" "tomli-w>=1.0" python -m pytest -q tests

Run the IDA-backed suite in an activated IDA environment:

uv run ida-mcp-test tests/typed_fixture.elf -q

New IDA tools live insrc/ida_pro_mcp/ida_mcp/api_*.pyand register through the@tooldecorator. Supervisor and worker lifecycle tests live undertests/.

Одна MCP-точка. Много бинарников. Контекст анализа сохраняется.

IDA Pro MCP Fusionподключает MCP-совместимых агентов к IDA Pro и превращает одно соединение в полноценное рабочее место для реверсинга. Живой анализ IDA объединён с постоянным SQLite-индексом и supervisor-процессом, который может держать несколько бинарников в изолированных headless-воркерах.

Можно декомпилировать и дизассемблировать функции, исследовать перекрёстные ссылки, типы и граф вызовов, переименовывать символы, патчить данные, создавать сигнатуры и повторно использовать уже построенный анализ.

Один раз активируйте headless Python от IDA:

# Windows — при необходимости измените версию и путь к IDA uv run "C:\Program Files\IDA Professional 9.3\idalib\python\py-activate-idalib.py"

# macOS — при необходимости измените версию и путь к IDA uv run "/Applications/IDA Professional 9.3.app/Contents/MacOS/idalib/python/py-activate-idalib.py"

Рекомендуемая конфигурация запускает код напрямую из этого репозитория:

Попросите подключённого агента начать так:

idb_open( "C:/samples/target.exe", preferred_session_id="target", build_caches=True, init_hexrays=True, )

Каждый следующий вызов анализа получает явный ID базы:

survey_binary(database="target") decompile("main", database="target") xrefs_to("WinMain", database="target") cache_callgraph_hotspots(limit=25, database="target")

- MCP-клиент запускаетidalib-mcpчерез stdio или HTTP.
- Supervisor создаёт или принимает по одному worker-процессу на каждый бинарник.
- Каждый вызов содержитdatabase, поэтому запрос попадает в нужную IDB-сессию.
- IDA выполняет живой анализ и изменения, а cache-инструменты читают индекс из SQLite.
- Воркеры остаются обнаруживаемыми на компьютере и завершаются после периода простоя.

Открыть несколько образцов и оставить все сессии доступными:

ida-pro-mcp --transport http://127.0.0.1:8744/sse

python -m pip install https://github.com/rison1337/ida-pro-mcp-fusion/archive/refs/heads/main.zip ida-pro-mcp --install