ida-pro-mcp-dsh

DeepSeek Harness adapter layer for ida-pro-mcp.

One-click plug the headless idalib MCP server from mrexodia/ida-pro-mcp into DSH, giving the model direct access to 66 mcp__idalib__* reverse engineering tools (decompile / disasm / xrefs_to / idb_open / survey_binary / find_bytes / …), purely headless idalib-driven, no IDA GUI required.

This is not a fork of ida-pro-mcp, nor does it contain its code. This repository only provides the DSH wiring (a cordis.patch.yml). The actual MCP server comes from the upstream repository, installed via pip install.

Installation

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

Restart dsh web for it to take effect. The model will see the mcp__idalib__* series of tools.

Related MCP server: IDA Auto MCP

Dependencies (install upstream first)

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

And activate idalib (so Python can find IDA's idalib.dll):

# 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 recommended), IDA Free is not supported

• idalib-mcp must be on PATH (after pip install, located in Python's Scripts directory)

Usage

Every tool requires the database parameter (the session id returned by 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")

You can also start with a binary directly: change args to ['--stdio', '/path/to/binary'].

Customization

The configuration line id for this bundle is mcp-idalib, with a default command: idalib-mcp. To specify a local idalib-mcp path or IDA installation directory, override it in the user layer of the profile's cordis.patch.yml (Cordis patch semantics: same id, last writer wins):

- 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 is read by the upstream idapro package with the highest priority, directly locating idalib.dll, bypassing the DSH MCP client's environment scrubbing (scrubbed env).

Uninstallation

Remove this bundle from DSH's Settings → Plugins management panel, or delete the corresponding line from the profile's package.json dsh.profile.bundles and restart.

Attribution / License

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

• This adapter layer: MIT, contains only DSH wiring (cordis.patch.yml) and documentation, no upstream code.

• See LICENSE.