IDA Pro MCP Fusion

io.github.rison1337由 GitHub 帳號 rison1337 發布v2.0.0更新於 Oct 24, 2026

IDA Pro MCP fusion with cache queries and multi-binary headless analysis.

已驗證STDIO僅桌面資料庫開發者工具安全與監控

概覽

AI 產生的概覽

將 MCP 編碼助理連接到本機已授權的 IDA Pro，用於反編譯、交叉參照與型別分析、修補，以及具快取的多二進位逆向分析。

可以做什麼
透過單一 stdio 端點提供約 75 個面向 IDA 的工具：工作階段控制（idb_open、idb_batch_open、idb_list、idb_close、idb_save）、概觀與反編譯（survey_binary、decompile、disasm、analyze_function）、搜尋與關聯（find、find_bytes、search_text、xrefs_to、callees、callgraph、trace_data_flow）、型別與堆疊、資料庫編輯（rename、set_comments、patch_asm、make_data）、簽章，以及選用的除錯器擴充。supervisor 可在隔離的無頭 worker 中同時開啟多個二進位檔，IDB 旁的 SQLite 快取則為函式、字串、全域變數、匯入、交叉參照與呼叫圖邊提供索引查詢。
適用情境
適合讓助理直接在 IDA Pro 中處理二進位檔：樣本初篩、反編譯與交叉參照追蹤、在同一工作階段中比對多個二進位檔，或重複使用已快取的分析結果，而不必反覆呼叫 IDA 的單執行緒 API。適用於逆向工程與惡意程式分析流程，而非一般編碼工作。
執行需求
需要本機已授權的 IDA Pro 8.3 或更新版本（建議 9.x），不支援 IDA Free。需要 Python 3.11+、uv/uvx，以及能啟動本機 stdio 伺服器的 MCP 用戶端。需先以 py-activate-idalib.py 啟用 IDA 的無頭 Python 環境。僅限桌面執行；未宣告驗證、環境變數或標頭。
安裝前請注意
修改類與任意 Python 工具被標示為 unsafe 且預設關閉；py_eval、py_exec_file、除錯器控制與修補操作可執行程式碼或永久變更 IDB，僅在可信用戶端與輸入下啟用。伺服器預設只綁定回送位址，不應暴露到不受信任的網路。分析不受信任的二進位檔時，請使用與手動惡意程式分析相同的隔離環境。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 IDA Pro MCP Fusion，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[English — selected] [Открыть русскую версию]

[Latest release] [Tests] [Python 3.11 or newer] [IDA Pro 8.3 or newer] [MCP over stdio or HTTP] [MIT license]

One MCP endpoint. Many binaries. Persistent analysis context.

Quick start · Why Fusion · Architecture · Tools · Configuration · Development

What is Fusion?

IDA Pro MCP Fusion connects 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.

[!IMPORTANT] This project requires a local, licensed installation of IDA Pro. IDA Free is not supported. The server does not provide IDA, Hex-Rays, or a hosted analysis service.

Why Fusion

CapabilityWhat it changes
⚡Persistent SQLite cacheFunctions, strings, globals, imports, xrefs, and call-graph edges remain queryable across repeated investigations.
◈Multi-binary supervisorOpen, address, and close several GUI or headless databases through one MCP endpoint.
⛓Persistent workersA later supervisor can discover and adopt an existing worker for the same database.
◎Batch-first workflowWarm analysis and build caches for a collection of samples with one idb_batch_open call.
⛨Controlled surfaceRead-only profiles, opt-in unsafe tools, worker limits, timeouts, and idle cleanup keep automation bounded.

The cache lives beside the IDB as <database>.mcp.sqlite. Freshness is checked against the IDB modification time and cache schema, so stale rows are not silently reused.

Quick start

1. Prerequisites

  • IDA Pro 8.3 or newer; IDA 9.x is recommended
  • Python 3.11 or newer
  • uv / uvx
  • Any MCP client that can launch a local stdio server

Install uv if it is not available:

bash
python -m pip install uv

Activate IDA's headless Python environment once:

powershell
# Windows — adjust the IDA version/path if neededuv run "C:\Program Files\IDA Professional 9.3\idalib\python\py-activate-idalib.py"
bash
# macOS — adjust the IDA version/path if neededuv run "/Applications/IDA Professional 9.3.app/Contents/MacOS/idalib/python/py-activate-idalib.py"

2. Add the MCP server

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

json
{  "mcpServers": {    "ida-pro-mcp-fusion": {      "command": "uvx",      "args": [        "--from",        "git+https://github.com/rison1337/ida-pro-mcp-fusion",        "idalib-mcp",        "--stdio"      ]    }  }}

Claude Code:

bash
claude mcp add ida-pro-mcp-fusion -- uvx --from git+https://github.com/rison1337/ida-pro-mcp-fusion idalib-mcp --stdio

Or download the packaged MCP bundle from the latest release.

3. Open a database

Ask the connected agent to start with:

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

Every analysis call then names its database explicitly:

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

Architecture

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

GUI databases can participate too. idb_open supports four routing modes:

ModeBehaviour
prefer_headlessUse or create an idalib worker. This is the default.
force_headlessNever adopt a running GUI instance.
prefer_guiAdopt a matching GUI instance, otherwise create a worker.
force_guiAdopt a matching GUI instance or launch IDA GUI.

Multi-binary workflow

Open a small collection and keep every session available:

python
idb_batch_open(    [        "C:/samples/loader.exe",        "C:/samples/payload.dll",        "C:/samples/helper.dll",    ],    session_prefix="case42",    refresh_cache=True,    cache_include_xrefs=True,)

For a large corpus, build each cache and release its worker immediately:

python
idb_batch_open(    ["C:/corpus/a.exe", "C:/corpus/b.exe", "C:/corpus/c.exe"],    close_after_cache=True,    retry_without_auto_analysis_on_timeout=True,)

Useful session controls:

python
idb_list()idb_close(database="case42_1_loader")

Tool surface

The codebase registers 75 IDA-facing analysis tools, plus the supervisor's multi-session controls. The exact number visible to a client intentionally varies: debugger tools are an extension, dangerous operations are disabled unless explicitly enabled, and a profile can expose a smaller allowlist.

AreaRepresentative tools
Sessionsidb_open, idb_batch_open, idb_list, idb_close, idb_save
Survey & decompilationsurvey_binary, decompile, disasm, analyze_function, analyze_component
Search & relationshipsfind, find_bytes, search_text, xrefs_to, callees, callgraph, trace_data_flow
Persistent cachecache_status, refresh_cache, cache_entity_query, cache_xrefs, cache_callgraph_hotspots, cache_find_regex
Types & stackdeclare_type, type_inspect, set_type, infer_types, stack_frame, declare_stack
Database editingrename, set_comments, define_func, define_code, patch_asm, make_data
Signaturesmake_signature, make_signature_for_function, make_signature_for_range, find_xref_signatures
Debugger extensiondbg_start, dbg_bps, dbg_regs, dbg_stacktrace, dbg_read, dbg_write

The nine cache-specific tools are:

text
cache_status              refresh_cachecache_refresh_if_stale    cache_list_funcscache_entity_query        cache_xrefscache_callgraph           cache_callgraph_hotspotscache_find_regex

Configuration

Worker pool

bash
uvx --from git+https://github.com/rison1337/ida-pro-mcp-fusion \  idalib-mcp --stdio --max-workers 4
Option / variablePurpose
--max-workers NMaximum simultaneous database workers; 0 means unlimited. Default: 4.
IDA_MCP_MAX_WORKERSEnvironment default for the worker limit.
IDA_MCP_OPEN_TIMEOUTMaximum auto-analysis open time in seconds. Default: 1800; 0 disables the limit.
IDA_MCP_LOAD_TIMEOUTMaximum load-only open time in seconds. Default: 300; 0 disables the limit.

Restricted profiles

Expose only a curated set of tools:

bash
idalib-mcp --stdio --profile profiles/readonly.txt

Two ready-to-use profiles are included:

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

HTTP transport

bash
idalib-mcp --host 127.0.0.1 --port 8745

IDA GUI bridge:

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

To install the GUI plugin and generate client configuration interactively:

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

Restart IDA and the MCP client after installation.

Safety notes

  • 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:

bash
idalib-mcp --stdio --unsafe

Troubleshooting

uvx is not recognized

Install uv with python -m pip install uv, open a new terminal, and confirm with uvx --version.

Python / IDA version mismatch

Run Hex-Rays idapyswitch, select a Python 3.11+ installation, then activate idalib again with py-activate-idalib.py.

A database call says that database is required

Call idb_list() and pass the returned session_id as database=. Paths and filenames are not accepted in place of a session ID.

The worker limit has been reached

Close an unused session with idb_close, raise --max-workers, or use close_after_cache=True for corpus indexing.

Development

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

bash
git clone https://github.com/rison1337/ida-pro-mcp-fusion.gitcd ida-pro-mcp-fusionpython -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:

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

New IDA tools live in src/ida_pro_mcp/ida_mcp/api_*.py and register through the @tool decorator. Supervisor and worker lifecycle tests live under tests/.

Project identity and credits

Fusion Edition is maintained by rison1337.

The project builds on the MIT-licensed mrexodia/ida-pro-mcp codebase. Its persistent cache and headless orchestration also incorporate ideas developed in QiuChenly/ida-pro-mcp-enhancement and winmin/ida-headless-mcp. Attribution is retained here and in the source history; Fusion's packaging, cache tooling, batch workflow, session lifecycle, and public identity are maintained in this repository.

License

Distributed under the MIT License. IDA Pro and Hex-Rays are trademarks of Hex-Rays SA and are not included with this project.

Русский

[Open English version] [Русский — выбран]

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

Быстрый старт · Почему Fusion · Архитектура · Инструменты · Настройка

Что такое Fusion?

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

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

[!IMPORTANT] Нужна локальная лицензированная установка IDA Pro. IDA Free не поддерживается. Сервер не содержит IDA, Hex-Rays и не отправляет бинарники во внешний сервис.

Почему Fusion

ВозможностьЧто это даёт
⚡Постоянный SQLite-кэшФункции, строки, глобальные переменные, импорты, xref и call graph доступны между запусками.
◈Мульти-бинарный supervisorНесколько GUI- или headless-баз управляются через одну MCP-точку.
⛓Живущие воркерыСледующее подключение может найти и принять уже запущенный worker для той же базы.
◎Пакетный анализОткрытие образцов и построение кэшей выполняется одним idb_batch_open.
⛨Контролируемый интерфейсRead-only-профили, лимит воркеров, тайм-ауты и opt-in для опасных инструментов.

Кэш лежит рядом с IDB в файле <database>.mcp.sqlite. Актуальность проверяется по времени изменения IDB и версии схемы, поэтому устаревшие данные не выдаются незаметно.

Быстрый старт

1. Что понадобится

  • IDA Pro 8.3 или новее; рекомендуется IDA 9.x
  • Python 3.11 или новее
  • uv / uvx
  • MCP-клиент, который умеет запускать локальный stdio-сервер

Установите uv, если его ещё нет:

bash
python -m pip install uv

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

powershell
# Windows — при необходимости измените версию и путь к IDAuv run "C:\Program Files\IDA Professional 9.3\idalib\python\py-activate-idalib.py"
bash
# macOS — при необходимости измените версию и путь к IDAuv run "/Applications/IDA Professional 9.3.app/Contents/MacOS/idalib/python/py-activate-idalib.py"

2. Добавьте MCP-сервер

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

json
{  "mcpServers": {    "ida-pro-mcp-fusion": {      "command": "uvx",      "args": [        "--from",        "git+https://github.com/rison1337/ida-pro-mcp-fusion",        "idalib-mcp",        "--stdio"      ]    }  }}

Для Claude Code:

bash
claude mcp add ida-pro-mcp-fusion -- uvx --from git+https://github.com/rison1337/ida-pro-mcp-fusion idalib-mcp --stdio

Готовый MCPB-пакет доступен в последнем релизе.

3. Откройте базу

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

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

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

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

Архитектура

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

idb_open поддерживает четыре режима:

РежимПоведение
prefer_headlessИспользовать или создать idalib-worker. Режим по умолчанию.
force_headlessНе принимать запущенный GUI-процесс.
prefer_guiПринять подходящий GUI, а если его нет — создать worker.
force_guiПринять GUI или запустить новый процесс IDA.

Работа с несколькими бинарниками

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

python
idb_batch_open(    [        "C:/samples/loader.exe",        "C:/samples/payload.dll",        "C:/samples/helper.dll",    ],    session_prefix="case42",    refresh_cache=True,    cache_include_xrefs=True,)

Для большого корпуса можно построить кэш и сразу освободить worker:

python
idb_batch_open(    ["C:/corpus/a.exe", "C:/corpus/b.exe", "C:/corpus/c.exe"],    close_after_cache=True,    retry_without_auto_analysis_on_timeout=True,)

Управление сессиями:

python
idb_list()idb_close(database="case42_1_loader")

Инструменты

В кодовой базе зарегистрировано 75 инструментов анализа IDA, а supervisor добавляет управление мульти-бинарными сессиями. Видимый клиенту список намеренно меняется: debugger-инструменты являются расширением, опасные операции отключены без явного разрешения, а профиль может оставить только выбранные имена.

ОбластьПримеры
Сессииidb_open, idb_batch_open, idb_list, idb_close, idb_save
Обзор и декомпиляцияsurvey_binary, decompile, disasm, analyze_function, analyze_component
Поиск и связиfind, find_bytes, search_text, xrefs_to, callees, callgraph, trace_data_flow
Постоянный кэшcache_status, refresh_cache, cache_entity_query, cache_xrefs, cache_callgraph_hotspots, cache_find_regex
Типы и стекdeclare_type, type_inspect, set_type, infer_types, stack_frame, declare_stack
Изменение базыrename, set_comments, define_func, define_code, patch_asm, make_data
Сигнатурыmake_signature, make_signature_for_function, make_signature_for_range, find_xref_signatures
Debugger-расширениеdbg_start, dbg_bps, dbg_regs, dbg_stacktrace, dbg_read, dbg_write

Настройка

Пул воркеров

bash
uvx --from git+https://github.com/rison1337/ida-pro-mcp-fusion \  idalib-mcp --stdio --max-workers 4
Параметр / переменнаяНазначение
--max-workers NМаксимум одновременно работающих баз; 0 — без лимита. По умолчанию 4.
IDA_MCP_MAX_WORKERSЗначение лимита по умолчанию из окружения.
IDA_MCP_OPEN_TIMEOUTМаксимальное время автоанализа при открытии в секундах. По умолчанию 1800.
IDA_MCP_LOAD_TIMEOUTМаксимальное время загрузки без автоанализа. По умолчанию 300.

Ограниченные профили

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

bash
idalib-mcp --stdio --profile profiles/readonly.txt

HTTP

bash
idalib-mcp --host 127.0.0.1 --port 8745

GUI-мост:

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

Для установки GUI-плагина:

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

После установки перезапустите IDA и MCP-клиент.

Безопасность

  • По умолчанию сервер слушает только loopback. Не открывайте его в недоверенную сеть.
  • Изменяющие и произвольные Python-инструменты помечены как unsafe и выключены по умолчанию.
  • py_eval, py_exec_file, debugger-команды и патчинг могут выполнять код или менять IDB.
  • Непроверенные бинарники анализируйте в той же изоляции, что и при ручном malware analysis.

Включить unsafe-инструменты можно явно:

bash
idalib-mcp --stdio --unsafe

Решение проблем

uvx не найден

Установите uv командой python -m pip install uv, откройте новый терминал и проверьте uvx --version.

Несовместимая версия Python или IDA

Запустите idapyswitch, выберите Python 3.11+, затем снова выполните py-activate-idalib.py.

Ошибка о том, что нужен database

Вызовите idb_list() и передайте возвращённый session_id как database=. Пути и имена файлов вместо ID сессии не принимаются.

Достигнут лимит воркеров

Закройте неиспользуемую сессию через idb_close, увеличьте --max-workers или используйте close_after_cache=True.

Разработка

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

Для тестов, которым нужна сама IDA:

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

Новые инструменты находятся в src/ida_pro_mcp/ida_mcp/api_*.py и регистрируются через @tool. Тесты supervisor и lifecycle — в tests/.

Проект и авторство

Fusion Edition поддерживается rison1337.

Проект основан на MIT-кодовой базе mrexodia/ida-pro-mcp. Постоянный кэш и headless-оркестрация также используют идеи из QiuChenly/ida-pro-mcp-enhancement и winmin/ida-headless-mcp. Атрибуция сохранена в README и истории исходников; упаковка Fusion, cache-инструменты, batch workflow и lifecycle сессий поддерживаются в этом репозитории.

Лицензия

Проект распространяется по MIT License. IDA Pro и Hex-Rays — товарные знаки Hex-Rays SA и не входят в состав проекта.

來源：README.md，提交 3bd6c5c

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v2.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分