https://github.com/mxiris-reverse-engineering/ida-mcp-server
A Model Context Protocol server for IDA
https://github.com/mxiris-reverse-engineering/ida-mcp-server
Last synced: 3 months ago
JSON representation
A Model Context Protocol server for IDA
- Host: GitHub
- URL: https://github.com/mxiris-reverse-engineering/ida-mcp-server
- Owner: MxIris-Reverse-Engineering
- License: mit
- Created: 2025-03-12T16:40:35.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-05-29T09:58:03.000Z (4 months ago)
- Last Synced: 2025-06-17T13:14:11.545Z (4 months ago)
- Language: Python
- Homepage:
- Size: 2.38 MB
- Stars: 450
- Watchers: 5
- Forks: 48
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# IDA MCP Server
> [!NOTE]
> The idalib mode is under development, and it will not require installing the IDA plugin or running IDA (idalib is available from IDA Pro 9.0+).
## Overview
A Model Context Protocol server for IDA interaction and automation. This server provides tools to read IDA database via Large Language Models.
Please note that mcp-server-ida is currently in early development. The functionality and available tools are subject to change and expansion as we continue to develop and improve the server.
## Installation
### Using uv (recommended)
When using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will
use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *mcp-server-ida*.
### Using PIP
Alternatively you can install `mcp-server-ida` via pip:
```
pip install mcp-server-ida
```
After installation, you can run it as a script using:
```
python -m mcp_server_ida
```
### IDA-Side
Copy `repository/plugin/ida_mcp_server_plugin.py` and `repository/plugin/ida_mcp_server_plugin` directory into IDAs plugin directory
Windows: `%APPDATA%\Hex-Rays\IDA Pro\plugins`
Linux/macOS: `$HOME/.idapro/plugins` eg: `~/.idapro/plugins`
[igors-tip-of-the-week-103-sharing-plugins-between-ida-installs](https://hex-rays.com/blog/igors-tip-of-the-week-103-sharing-plugins-between-ida-installs)
## Configuration
### Usage with Claude Desktop
Add this to your `claude_desktop_config.json`:
Using uvx
```json
"mcpServers": {
"ida": {
"command": "uvx",
"args": [
"mcp-server-ida"
]
}
}
```
Using pip installation
```json
"mcpServers": {
"ida": {
"command": "python",
"args": [
"-m",
"mcp_server_ida"
]
}
}
```
## Debugging
You can use the MCP inspector to debug the server. For uvx installations:
```
npx @modelcontextprotocol/inspector uvx mcp-server-ida
```
Or if you've installed the package in a specific directory or are developing on it:
```
cd path/to/mcp-server-ida/src
npx @modelcontextprotocol/inspector uv run mcp-server-ida
```
Running `tail -n 20 -f ~/Library/Logs/Claude/mcp*.log` will show the logs from the server and may
help you debug any issues.
## Development
If you are doing local development, there are two ways to test your changes:
1. Run the MCP inspector to test your changes. See [Debugging](#debugging) for run instructions.
2. Test using the Claude desktop app. Add the following to your `claude_desktop_config.json`:
### UVX
```json
{
"mcpServers": {
"ida": {
"command": "uv",
"args": [
"--directory",
"/",
"run",
"mcp-server-ida"
]
}
}
```
## Alternatives
[ida-pro-mcp](https://github.com/mrexodia/ida-pro-mcp)
[ida-mcp-server-plugin](https://github.com/taida957789/ida-mcp-server-plugin)
[mcp-server-idapro](https://github.com/fdrechsler/mcp-server-idapro)
[pcm](https://github.com/rand-tech/pcm)
## Screenshots
