ida-pro-mcp-dsh

ida-pro-mcp의 DeepSeek Harness 어댑터 계층입니다.

mrexodia/ida-pro-mcp의 headless idalib MCP 서버를 DSH에 한 번에 연결하여, 모델이 66개의 mcp__idalib__* 리버스 엔지니어링 도구(decompile / disasm / xrefs_to / idb_open / survey_binary / find_bytes / …)를 직접 사용할 수 있습니다. 순수 headless idalib 기반으로 IDA GUI가 필요 없습니다.

이는 ida-pro-mcp의 포크가 아니며, 해당 코드를 포함하지 않습니다. 이 저장소는 DSH 연결 코드(cordis.patch.yml)만 제공합니다. 실제 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 클라이언트의 환경 정리(scrubbed env)를 우회합니다.

제거

DSH의 Settings → Plugins 관리 패널에서 이 번들을 제거하거나, 프로필 package.json의 dsh.profile.bundles에서 해당 줄을 삭제한 후 다시 시작하세요.

귀속 / License

• 상위: mrexodia/ida-pro-mcp, MIT © 2025 Duncan Ogilvie 및 기여자.

• 본 어댑터 계층: MIT, DSH 연결 코드(cordis.patch.yml)와 문서만 포함하며, 상위 코드는 포함하지 않습니다.

• 자세한 내용은 LICENSE를 참조하세요.