ida-pro-mcp-dsh

ida-pro-mcp の DeepSeek Harness アダプテーションレイヤー。

mrexodia/ida-pro-mcp の ヘッドレス idalib MCP サーバー を DSH にワンクリックで接続し、モデルが直接 66 個の mcp__idalib__* リバースエンジニアリングツール（decompile / disasm / xrefs_to / idb_open / survey_binary / find_bytes / …）を利用可能にします。完全にヘッドレスな idalib 駆動で、IDA GUI は不要です。

これは ida-pro-mcp のフォークではなく、そのコードも含んでいません。 このリポジトリは DSH 接続線 （cordis.patch.yml 1 ファイル）のみを提供します。実際の MCP サーバーは上流リポジトリから 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 が IDA の 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 推奨）、IDA Free は非対応

• idalib-mcp が PATH 上にあること（pip インストール後、Python の Scripts ディレクトリに配置されます）

使用法

各ツールは database パラメータ（idb_open が返すセッション ID）を必要とします：

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'] に変更します。

カスタマイズ

このバンドルの設定行 ID は 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 を直接特定します。 DSH MCP クライアントによる環境のスクラブを回避します。

アンインストール

DSH の Settings → Plugins 管理パネルからこのバンドルを削除するか、プロファイルの package.json にある dsh.profile.bundles から該当行を削除して再起動します。

帰属 / ライセンス

• 上流：mrexodia/ida-pro-mcp、MIT © 2025 Duncan Ogilvie およびコントリビューター。

• 本アダプテーションレイヤー：MIT、DSH 接続線（cordis.patch.yml）とドキュメントのみを含み、上流コードは含みません。

• 詳細は LICENSE を参照。