$git clone https://github.com/mrexodia/ida-pro-mcpSimple MCP Server to allow vibe reversing in IDA Pro.
| 1 | # IDA Pro MCP |
| 2 | |
| 3 | Simple [MCP Server](https://modelcontextprotocol.io/introduction) to allow vibe reversing in IDA Pro. |
| 4 | |
| 5 | https://github.com/user-attachments/assets/6ebeaa92-a9db-43fa-b756-eececce2aca0 |
| 6 | |
| 7 | The binaries and prompt for the video are available in the [mcp-reversing-dataset](https://github.com/mrexodia/mcp-reversing-dataset) repository. |
| 8 | |
| 9 | ## Prerequisites |
| 10 | |
| 11 | - [Python](https://www.python.org/downloads/) (**3.11 or higher**) |
| 12 | - Use `idapyswitch` to switch to the newest Python version |
| 13 | - [IDA Pro](https://hex-rays.com/ida-pro) (8.3 or higher, 9 recommended), **IDA Free is not supported** |
| 14 | - Supported MCP Client (pick one you like) |
| 15 | - [Amazon Q Developer CLI](https://aws.amazon.com/q/developer/) |
| 16 | - [Augment Code](https://www.augmentcode.com/) |
| 17 | - [Claude](https://claude.ai/download) |
| 18 | - [Claude Code](https://www.anthropic.com/code) |
| 19 | - [Cline](https://cline.bot) |
| 20 | - [Codex](https://github.com/openai/codex) |
| 21 | - [Copilot CLI](https://docs.github.com/en/copilot) |
| 22 | - [Crush](https://github.com/charmbracelet/crush) |
| 23 | - [Cursor](https://cursor.com) |
| 24 | - [Gemini CLI](https://google-gemini.github.io/gemini-cli/) |
| 25 | - [Kilo Code](https://kilo.ai/) |
| 26 | - [Kiro](https://kiro.dev/) |
| 27 | - [LM Studio](https://lmstudio.ai/) |
| 28 | - [Opencode](https://opencode.ai/) |
| 29 | - [Qodo Gen](https://www.qodo.ai/) |
| 30 | - [Qwen Coder](https://qwenlm.github.io/qwen-code-docs/) |
| 31 | - [Roo Code](https://roocode.com) |
| 32 | - [Trae](https://trae.ai/) |
| 33 | - [VS Code](https://code.visualstudio.com/) |
| 34 | - [VS Code Insiders](https://code.visualstudio.com/insiders) |
| 35 | - [Warp](https://www.warp.dev/) |
| 36 | - [Windsurf](https://windsurf.com) |
| 37 | - [Zed](https://zed.dev/) |
| 38 | - [Kimi Code](https://moonshotai.github.io/kimi-code/en/) |
| 39 | - [Other MCP Clients](https://modelcontextprotocol.io/clients#example-clients): Run `ida-pro-mcp --config` to get the JSON config for your client. |
| 40 | |
| 41 | **Note**: This requires having idalib activated globally and [uv](https://astral.sh/uv) installed: |
| 42 | |
| 43 | ```bash |
| 44 | # windows |
| 45 | uv run "C:\Program Files\IDA Professional 9.3\idalib\python\py-activate-idalib.py" |
| 46 | # macos |
| 47 | uv run "/Applications/IDA Professional 9.3.app/Contents/MacOS/idalib/python/py-activate-idalib.py" |
| 48 | ``` |
| 49 | |
| 50 | ## Installation (Claude Code) |
| 51 | |
| 52 | To install the latest IDA Pro MCP in Claude Code: |
| 53 | |
| 54 | ```bash |
| 55 | claude plugin marketplace add mrexodia/claude-marketplace |
| 56 | claude plugin uninstall ida-pro-mcp@mrexodia |
| 57 | claude plugin install ida-pro-mcp@mrexodia |
| 58 | ``` |
| 59 | |
| 60 | ## Installation (Codex) |
| 61 | |
| 62 | To install the latest IDA Pro MCP in Codex: |
| 63 | |
| 64 | ```bash |
| 65 | codex plugin marketplace add mrexodia/codex-marketplace |
| 66 | codex plugin remove ida-pro-mcp@mrexodia |
| 67 | codex plugin add ida-pro-mcp@mrexodia |
| 68 | ``` |
| 69 | |
| 70 | ## Installation (Kimi Code) |
| 71 | |
| 72 | To install the latest IDA Pro MCP in Kimi Code, run this slash command in the chat: |
| 73 | |
| 74 | ``` |
| 75 | /plugins install https://github.com/mrexodia/ida-pro-mcp/tree/main |
| 76 | /reload |
| 77 | ``` |
| 78 | |
| 79 | This installs the `idalib` MCP server and the `idapython` skill. Plugins are copied to |
| 80 | `$KIMI_CODE_HOME/plugins/managed/`, so `uv` must be on your `PATH`. The first session after |
| 81 | installing is slower, because `uv` resolves the dependencies before the server responds. |
| 82 | |
| 83 | ## Installation (GUI) |
| 84 | |
| 85 | **Note**: the MCP plugin is no longer recommended and will eventually be deprecated. Use `idalib-mcp` instead. |
| 86 | |
| 87 | If you want to configure the MCP server manually from the IDA GUI: |
| 88 | |
| 89 | ```sh |
| 90 | pip uninstall ida-pro-mcp |
| 91 | pip install https://github.com/mrexodia/ida-pro-mcp/archive/refs/heads/main.zip |
| 92 | ``` |
| 93 | |
| 94 | Configure the MCP servers and install the IDA Plugin: |
| 95 | |
| 96 | ``` |
| 97 | ida-pro-mcp --install |
| 98 | ``` |
| 99 | |
| 100 | **Important**: Make sure you completely restart IDA and your MCP client for the installation to take effect. Some clients (like Claude) run in the background and need to be quit from the tray icon. |
| 101 | |
| 102 | ## Prompt Engineering |
| 103 | |
| 104 | LLMs are prone to hallucinations and you need to be specific with your prompting. For reverse engineering the conversion between integers and bytes are especially problematic. Below is a minimal example prompt, feel free to start a discussion or open an issue if you have good results with a d |