ida-pro-mcp-dsh

ida-pro-mcp Capa de adaptación DeepSeek Harness.

Con un solo clic, monta el headless idalib MCP server de mrexodia/ida-pro-mcp en DSH, y el modelo obtiene directamente 66 herramientas de ingeniería inversa mcp__idalib__* (decompile / disasm / xrefs_to / idb_open / survey_binary / find_bytes / …), totalmente impulsado por idalib sin cabeza, sin necesidad de IDA GUI.

Esto no es un fork de ida-pro-mcp, ni contiene su código. Este repositorio solo proporciona el cableado DSH (un archivo cordis.patch.yml). El MCP server real proviene del repositorio upstream, instalado mediante pip install.

Instalación

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

Reinicia dsh web para que surta efecto. El modelo verá las herramientas de la serie mcp__idalib__*.

Related MCP server: IDA Auto MCP

Dependencias (instalar upstream primero)

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

Y activar idalib (para que Python pueda encontrar idalib.dll de 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+ (se recomienda 9), IDA Free no compatible

• idalib-mcp debe estar en PATH (tras la instalación con pip se encuentra en el directorio Scripts de Python)

Uso

Cada herramienta requiere el parámetro database (el session id devuelto por 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")

También se puede iniciar directamente con un binario: cambia args a ['--stdio', '/path/to/binary'].

Personalización

El ID de la línea de configuración de este bundle es mcp-idalib, con command: idalib-mcp por defecto. Para especificar una ruta local idalib-mcp o el directorio de instalación de IDA, sobrescribe en la capa de usuario del cordis.patch.yml del perfil (semántica de parche Cordis: para el mismo id, gana el último escritor):

- 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 será leído por el paquete upstream idapro con la máxima prioridad, localizando directamente idalib.dll, evitando la limpieza del entorno (scrubbed env) del cliente DSH MCP.

Desinstalación

Elimina este bundle desde el panel de administración de Settings → Plugins de DSH, o borra la línea correspondiente en dsh.profile.bundles del archivo package.json del perfil y reinicia.

Atribución / Licencia

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

• Esta capa de adaptación: MIT, contiene solo el cableado DSH (cordis.patch.yml) y la documentación, sin código upstream.

• Ver LICENSE.