ida-pro-mcp-dsh

ida-pro-mcp DeepSeek Harness Adapter-Schicht.

Hängt den headless idalib MCP-Server von mrexodia/ida-pro-mcp mit einem Klick in DSH ein, das Modell erhält direkt 66 mcp__idalib__* Reverse-Engineering-Werkzeuge (decompile / disasm / xrefs_to / idb_open / survey_binary / find_bytes / …), rein headless idalib-gesteuert, keine IDA-GUI erforderlich.

Dies ist kein Fork von ida-pro-mcp und enthält keinen dessen Codes. Dieses Repository stellt nur die DSH-Verbindung (eine cordis.patch.yml) bereit. Der eigentliche MCP-Server stammt aus dem Upstream-Repository und wird über pip install installiert.

Installation

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

Nach Neustart von dsh web aktiv. Das Modell sieht die Werkzeuge der Serie mcp__idalib__*.

Related MCP server: IDA Auto MCP

Abhängigkeiten (zuerst Upstream installieren)

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

Und idalib aktivieren (damit Python die idalib.dll von IDA findet):

# 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 empfohlen), IDA Free wird nicht unterstützt

• idalib-mcp muss im PATH sein (nach pip-Installation im Scripts-Verzeichnis von Python)

Verwendung

Jedes Werkzeug benötigt den Parameter database (Session-ID, die von idb_open zurückgegeben wird):

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")

Alternativ kann die Binärdatei direkt beim Start übergeben werden: args auf ['--stdio', '/pfad/zur/binary'] ändern.

Anpassung

Die Konfigurationszeilen-ID dieses Bundles ist mcp-idalib, standardmäßig command: idalib-mcp. Um einen lokalen idalib-mcp-Pfad oder das IDA-Installationsverzeichnis anzugeben, im Profil die Benutzerebene von cordis.patch.yml überschreiben (Cordis-Patch-Semantik: Bei gleicher ID gewinnt der letzte Schreibzugriff):

- 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 wird vom Upstream-Paket idapro mit höchster Priorität gelesen, lokalisiert idalib.dll direkt und umgeht die Bereinigung der Umgebung (scrubbed env) durch den DSH-MCP-Client.

Deinstallation

Entfernen Sie dieses Bundle im DSH-Einstellungen → Plugins-Verwaltungsbereich oder löschen Sie die entsprechende Zeile aus der dsh.profile.bundles-Liste in der package.json des Profils und starten Sie neu.

Zugehörigkeit / Lizenz

• Upstream: mrexodia/ida-pro-mcp, MIT © 2025 Duncan Ogilvie und Mitwirkende.

• Diese Adapter-Schicht: MIT, enthält nur die DSH-Verbindung (cordis.patch.yml) und Dokumentation, keinen Upstream-Code.

• Siehe LICENSE.