ida-pro-mcp-dsh

ida-pro-mcp — адаптационный слой DeepSeek Harness (DSH).

Одним щелчком подключает headless idalib MCP server от mrexodia/ida-pro-mcp к DSH, модель получает напрямую 66 инструментов обратной разработки mcp__idalib__* (decompile / disasm / xrefs_to / idb_open / survey_binary / find_bytes / …), полностью управляемых через headless idalib, без GUI IDA.

Это не форк ida-pro-mcp и не содержит его кода. В данном репозитории предоставляется только подключение DSH (файл cordis.patch.yml). Фактический MCP server находится в вышестоящем репозитории и устанавливается через pip install.

Установка

dsh plugin --profile web add "github:Xilin3/ida-pro-mcp-dsh#main"

После перезапуска dsh web изменения вступят в силу. Модель увидит набор инструментов mcp__idalib__*.

Related MCP server: IDA Auto MCP

Зависимости (сначала установите вышестоящий пакет)

pip install "https://github.com/mrexodia/ida-pro-mcp/archive/refs/heads/main.zip"

и активируйте idalib (чтобы Python мог найти idalib.dll от IDA):

# Windows：推荐直接设 IDADIR 指向 IDA 安装目录（最高优先级，见下方「自定义」）
# 或运行 IDA 自带的激活脚本，把安装目录写进 ida-config.json：
uv run "C:\Program Files\IDA Professional 9.3\idalib\python\py-activate-idalib.py"

• Python ≥ 3.11

• IDA Pro 8.3+ (рекомендуется 9), IDA Free не поддерживается

• idalib-mcp должен быть в PATH (после pip install находится в каталоге Scripts Python)

Использование

Каждый инструмент требует параметр database (идентификатор сессии, возвращаемый idb_open):

mcp__idalib__idb_open("/path/to/binary.exe", preferred_session_id="xxx")
mcp__idalib__survey_binary(database="xxx")          # 开图第一步：段/入口/字符串/函数总览
mcp__idalib__decompile("main", database="xxx")
mcp__idalib__xrefs_to("ImportantExport", database="xxx")

Также можно сразу запускать с бинарником: измените args на ['--stdio', '/path/to/binary'].

Настройка

Идентификатор строки конфигурации этого bundle — mcp-idalib, по умолчанию command: idalib-mcp. Чтобы указать локальный путь к idalib-mcp или каталог установки IDA, переопределите в профиле в пользовательском слое cordis.patch.yml (семантика патча Cordis: при одинаковом id последний записанный побеждает):

- insert:
    - id: mcp-idalib
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: idalib
        transport: stdio
        command: 'C:\Users\<you>\AppData\Local\Programs\Python\Python312\Scripts\idalib-mcp.exe'
        args:
          - '--stdio'
        env:
          PYTHONUTF8: '1'
          IDADIR: 'D:\IDA Professional 9.3'   # 指向 IDA 安装目录，最高优先级
        toolCallTimeoutMs: 600000

IDADIR будет прочитан с наивысшим приоритетом пакетом idapro, напрямую указывая на idalib.dll, обходя очистку окружения (scrubbed env) MCP-клиента DSH.

Удаление

Удалите этот bundle в панели управления DSH (Settings → Plugins) или удалите соответствующую строку из dsh.profile.bundles в файле package.json профиля и перезапустите.

Авторство / Лицензия

• Вышестоящий проект: mrexodia/ida-pro-mcp, MIT © 2025 Duncan Ogilvie и участники.

• Данный адаптационный слой: MIT, содержит только подключение DSH (cordis.patch.yml) и документацию, без кода вышестоящего проекта.

• Подробнее см. LICENSE.