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.
Badge for your README
Markdown
[](/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
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)
- {
- "name": "ida-mcp",
- "version": "20261028.0.3",
- "description": "Official Hex-Rays IDA MCP Server.",
- "mcpServers": {
- "ida": {
- "command": "uv",
- "args": [
- "run",
- "--no-dev",
- "--project",
- "${CLAUDE_PLUGIN_ROOT}",
- "ida-mcp",
- "stdio",
- "--agent=claude"
- ],
- "env": {
- "IDA_MCP_ID": "${IDA_MCP_ID:-}",
- "IDA_MCP_IDLE_TIMEOUT": "${IDA_MCP_IDLE_TIMEOUT:-}",
- "IDAUSR": "${IDAUSR:-}",
- "IDAPYTHON_VENV_EXECUTABLE": "${IDAPYTHON_VENV_EXECUTABLE:-}",
- "IDA_NEXUS_IDALIB_ONLY": "${IDA_NEXUS_IDALIB_ONLY:-}",
- "IDA_NEXUS_STATE_DIR": "${IDA_NEXUS_STATE_DIR:-}",
- "IDA_MCP_STATE_DIR": "${IDA_MCP_STATE_DIR:-}",
- "IDAPYTHON_VENV_EXECUTABLE": "${IDAPYTHON_VENV_EXECUTABLE:-}",
- "IDA_NEXUS_IDALIB_ONLY": "${IDA_NEXUS_IDALIB_ONLY:-}"
- }
- }
- },
- "hooks": {
- "PreToolUse": [
- {
- "matcher": "mcp__(.*[_:])?ida__.*",
- "hooks": [
- {
- "type": "command",
- "command": "uv run --no-dev --project ${CLAUDE_PLUGIN_ROOT} ida-mcp hook claude"
- }
- ]
- }
- ]
- }
- }
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)
- # Hex-Rays IDA MCP
- Official Hex-Rays IDA MCP Server, see the [announcement blog post](https://hex-rays.com/blog/hex-rays-ida-mcp-server) for more information.
- ## Installation
- ### 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/):
- ```bash
- 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:
- ```bash
- 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)
- ```bash
- # 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)
- ```bash
- # 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)
- ```bash
- # 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/)
- ```bash
- # 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)
- ```bash
- # 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:
- ```json
- {
- "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>
- ## CLI
- ```bash
- # MCP server over standard input/output
- uvx ida-mcp stdio --agent=my-agent
- # MCP server over Streamable HTTP
- uvx ida-mcp http --host 127.0.0.1 --port 8737
- # Inspect session log
- uvx ida-mcp dashboard --open
- # Export session logs for troubleshooting
- uvx ida-mcp logs
- ```
- ## Usage
- Start your agent harness and ask it something like:
- > Reverse /path/to/sample.elf for me in IDA
- To test the GUI integration, open something in IDA and ask your harness:
- > What do I have open in the IDA GUI?
- ## Developers: IDA Nexus
- The IDA MCP project is built on [IDA Nexus](https://github.com/HexRaysSA/ida-nexus),
- which allows multiple clients to seamlessly share and operate on IDA databases.
- You can build your own tools on top of the `ida-nexus` library, see
- [the documentation](https://github.com/HexRaysSA/ida-nexus/blob/main/README.md#python-package-developers)
- 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 inFree to use. If it’s helped, pass it on.