Skip to content
Back to search

ida-mcp

Official Hex-Rays IDA MCP Server.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hexrayssa--ida-mcp/badge.svg)](/listings/hexrayssa--ida-mcp)

HTML

<a href="/listings/hexrayssa--ida-mcp"><img src="/api/listings/hexrayssa--ida-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requirements

- Installed in your PATH - [Git](https://git-scm.com/) - [uv](https://github.com/astral-sh/uv) - IDA 9.4 or higher with idalib and Python 3.11+ - We recommend disabling other IDA MCP servers to reduce agent confusion

Automatic installation

Install the Hex-Rays IDA MCP using [hcli](https://hcli.docs.hex-rays.com/):

uvx ida-hcli mcp install
# or if you have hcli installed:
hcli mcp install

This will install the GUI plugin and interactively offer you to install the supported agent plugins.

Manual installation

<details>

<summary>Manual installation instructions...</summary>

IDA GUI Plugin

To support IDA GUI instances when using IDA MCP, install the plugin:

uvx ida-hcli plugin install ida-mcp@https://github.com/HexRaysSA/ida-mcp
# or if you have hcli installed:
hcli plugin install ida-mcp@https://github.com/HexRaysSA/ida-mcp

_Note_: Without the plugin, IDA MCP still works headlessly, in a worker that uses the Python environment of the MCP server. With the plugin installed, headless workers run inside `idat` with IDA's own Python, so IDA plugins and the packages installed for IDA are available, and the agent can ask for `gui=true` to open a file in the IDA GUI. Set `IDA_NEXUS_IDALIB_ONLY=1` to keep workers in the server's Python environment regardless.

[Claude Code](https://claude.com/product/claude-code)

# Add Hex-Rays marketplace
claude plugin marketplace add HexRaysSA/claude-marketplace
# Install plugin
claude plugin install ida-mcp@HexRaysSA
# Update to latest version
claude plugin update ida-mcp@HexRaysSA

[Codex CLI](https://learn.chatgpt.com/docs/codex/cli)

# Add Hex-Rays marketplace
codex plugin marketplace add HexRaysSA/codex-marketplace
# Install plugin
codex plugin add ida-mcp@HexRaysSA

[GitHub Copilot CLI](https://github.com/features/copilot/cli)

# Add Hex-Rays marketplace
copilot plugin marketplace add HexRaysSA/copilot-marketplace
# Install plugin
copilot plugin install ida-mcp@HexRaysSA
# Update to latest version
copilot plugin update ida-mcp

[Pi](https://pi.dev/)

# Install extension
pi install git:github.com/HexRaysSA/ida-mcp@latest
# Update to latest version
pi update --extensions

[oh-my-pi](https://github.com/can1357/oh-my-pi)

# Install extension
omp plugin install github:HexRaysSA/ida-mcp#latest
# Update to latest version
omp plugin upgrade

Other agents

Configure a regular stdio MCP server in your MCP JSON configuration:

{
  "mcpServers": {
    "ida": {
      "command": "uvx",
      "args": [
        "--exclude-newer=1s",
        "ida-mcp",
        "stdio",
        "--agent=my-agent"
      ]
    }
  }
}

`uvx` resolves the latest stable `ida-mcp` release from PyPI, so this configuration does not need to be updated for each release.

`--agent=my-agent` is a human-chosen label (like `claude-code`, `cursor`, `my-custom-agent`, etc.) used to differentiate sessions in the dashboard.

</details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/plugin.json · Manifest · 43 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "ida-mcp",
  3. "version": "20261028.0.3",
  4. "description": "Official Hex-Rays IDA MCP Server.",
  5. "mcpServers": {
  6. "ida": {
  7. "command": "uv",
  8. "args": [
  9. "run",
  10. "--no-dev",
  11. "--project",
  12. "${CLAUDE_PLUGIN_ROOT}",
  13. "ida-mcp",
  14. "stdio",
  15. "--agent=claude"
  16. ],
  17. "env": {
  18. "IDA_MCP_ID": "${IDA_MCP_ID:-}",
  19. "IDA_MCP_IDLE_TIMEOUT": "${IDA_MCP_IDLE_TIMEOUT:-}",
  20. "IDAUSR": "${IDAUSR:-}",
  21. "IDAPYTHON_VENV_EXECUTABLE": "${IDAPYTHON_VENV_EXECUTABLE:-}",
  22. "IDA_NEXUS_IDALIB_ONLY": "${IDA_NEXUS_IDALIB_ONLY:-}",
  23. "IDA_NEXUS_STATE_DIR": "${IDA_NEXUS_STATE_DIR:-}",
  24. "IDA_MCP_STATE_DIR": "${IDA_MCP_STATE_DIR:-}",
  25. "IDAPYTHON_VENV_EXECUTABLE": "${IDAPYTHON_VENV_EXECUTABLE:-}",
  26. "IDA_NEXUS_IDALIB_ONLY": "${IDA_NEXUS_IDALIB_ONLY:-}"
  27. }
  28. }
  29. },
  30. "hooks": {
  31. "PreToolUse": [
  32. {
  33. "matcher": "mcp__(.*[_:])?ida__.*",
  34. "hooks": [
  35. {
  36. "type": "command",
  37. "command": "uv run --no-dev --project ${CLAUDE_PLUGIN_ROOT} ida-mcp hook claude"
  38. }
  39. ]
  40. }
  41. ]
  42. }
  43. }
README.md · README · 160 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Hex-Rays IDA MCP
  2. Official Hex-Rays IDA MCP Server, see the [announcement blog post](https://hex-rays.com/blog/hex-rays-ida-mcp-server) for more information.
  3. ## Installation
  4. ### Requirements
  5. - Installed in your PATH
  6. - [Git](https://git-scm.com/)
  7. - [uv](https://github.com/astral-sh/uv)
  8. - IDA 9.4 or higher with idalib and Python 3.11+
  9. - We recommend disabling other IDA MCP servers to reduce agent confusion
  10. ### Automatic installation
  11. Install the Hex-Rays IDA MCP using [hcli](https://hcli.docs.hex-rays.com/):
  12. ```bash
  13. uvx ida-hcli mcp install
  14. # or if you have hcli installed:
  15. hcli mcp install
  16. ```
  17. This will install the GUI plugin and interactively offer you to install the supported agent plugins.
  18. ### Manual installation
  19. <details>
  20. <summary>Manual installation instructions...</summary>
  21. #### IDA GUI Plugin
  22. To support IDA GUI instances when using IDA MCP, install the plugin:
  23. ```bash
  24. uvx ida-hcli plugin install ida-mcp@https://github.com/HexRaysSA/ida-mcp
  25. # or if you have hcli installed:
  26. hcli plugin install ida-mcp@https://github.com/HexRaysSA/ida-mcp
  27. ```
  28. _Note_: Without the plugin, IDA MCP still works headlessly, in a worker that
  29. uses the Python environment of the MCP server. With the plugin installed,
  30. headless workers run inside `idat` with IDA's own Python, so IDA plugins and
  31. the packages installed for IDA are available, and the agent can ask for
  32. `gui=true` to open a file in the IDA GUI. Set `IDA_NEXUS_IDALIB_ONLY=1` to
  33. keep workers in the server's Python environment regardless.
  34. #### [Claude Code](https://claude.com/product/claude-code)
  35. ```bash
  36. # Add Hex-Rays marketplace
  37. claude plugin marketplace add HexRaysSA/claude-marketplace
  38. # Install plugin
  39. claude plugin install ida-mcp@HexRaysSA
  40. # Update to latest version
  41. claude plugin update ida-mcp@HexRaysSA
  42. ```
  43. #### [Codex CLI](https://learn.chatgpt.com/docs/codex/cli)
  44. ```bash
  45. # Add Hex-Rays marketplace
  46. codex plugin marketplace add HexRaysSA/codex-marketplace
  47. # Install plugin
  48. codex plugin add ida-mcp@HexRaysSA
  49. ```
  50. #### [GitHub Copilot CLI](https://github.com/features/copilot/cli)
  51. ```bash
  52. # Add Hex-Rays marketplace
  53. copilot plugin marketplace add HexRaysSA/copilot-marketplace
  54. # Install plugin
  55. copilot plugin install ida-mcp@HexRaysSA
  56. # Update to latest version
  57. copilot plugin update ida-mcp
  58. ```
  59. #### [Pi](https://pi.dev/)
  60. ```bash
  61. # Install extension
  62. pi install git:github.com/HexRaysSA/ida-mcp@latest
  63. # Update to latest version
  64. pi update --extensions
  65. ```
  66. #### [oh-my-pi](https://github.com/can1357/oh-my-pi)
  67. ```bash
  68. # Install extension
  69. omp plugin install github:HexRaysSA/ida-mcp#latest
  70. # Update to latest version
  71. omp plugin upgrade
  72. ```
  73. #### Other agents
  74. Configure a regular stdio MCP server in your MCP JSON configuration:
  75. ```json
  76. {
  77. "mcpServers": {
  78. "ida": {
  79. "command": "uvx",
  80. "args": [
  81. "--exclude-newer=1s",
  82. "ida-mcp",
  83. "stdio",
  84. "--agent=my-agent"
  85. ]
  86. }
  87. }
  88. }
  89. ```
  90. `uvx` resolves the latest stable `ida-mcp` release from PyPI, so this
  91. configuration does not need to be updated for each release.
  92. `--agent=my-agent` is a human-chosen label (like `claude-code`, `cursor`,
  93. `my-custom-agent`, etc.) used to differentiate sessions in the dashboard.
  94. </details>
  95. ## CLI
  96. ```bash
  97. # MCP server over standard input/output
  98. uvx ida-mcp stdio --agent=my-agent
  99. # MCP server over Streamable HTTP
  100. uvx ida-mcp http --host 127.0.0.1 --port 8737
  101. # Inspect session log
  102. uvx ida-mcp dashboard --open
  103. # Export session logs for troubleshooting
  104. uvx ida-mcp logs
  105. ```
  106. ## Usage
  107. Start your agent harness and ask it something like:
  108. > Reverse /path/to/sample.elf for me in IDA
  109. To test the GUI integration, open something in IDA and ask your harness:
  110. > What do I have open in the IDA GUI?
  111. ## Developers: IDA Nexus
  112. The IDA MCP project is built on [IDA Nexus](https://github.com/HexRaysSA/ida-nexus),
  113. which allows multiple clients to seamlessly share and operate on IDA databases.
  114. You can build your own tools on top of the `ida-nexus` library, see
  115. [the documentation](https://github.com/HexRaysSA/ida-nexus/blob/main/README.md#python-package-developers)
  116. for more information.

Version history

  • v20261028.0.310/29/2026

  • v20261023.0.210/24/2026

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.