License

Skip to content

You signed in with another tab or window. Reload
to refresh your session. You signed out in another tab or window. Reload
to refresh your session. You switched accounts on another tab or window. Reload
to refresh your session. Dismiss alert

MxIris-Reverse-Engineering / ida-mcp-server Public

• Notifications
  You must be signed in to change notification settings

• Fork 34

• Star 307

A Model Context Protocol server for IDA

License

MIT license

307 stars
34 forks
Branches
Tags
Activity

Star

Notifications
You must be signed in to change notification settings

MxIris-Reverse-Engineering/ida-mcp-server

main

1 Branch
6 Tags

Go to file

Code

Folders and files

| Name | | Name | Last commit message | Last commit date |
| --- | --- | --- | --- |
| Latest commit
-------------


Mx-Iris

Update README.md

Mar 28, 2025

1bf3bea
 · Mar 28, 2025

History
-------

28 Commits

| | |
| Screenshots | | Screenshots | Update README | Mar 15, 2025 |
| plugin | | plugin | Merge pull request
#4
from Satar07/main | Mar 27, 2025 |
| src/mcp_server_ida | | src/mcp_server_ida | Add multi-variable and multi-function renaming features | Mar 27, 2025 |
| test | | test | Remove timeout settings | Mar 27, 2025 |
| .gitignore | | .gitignore | Add execute script features | Mar 26, 2025 |
| LICENSE | | LICENSE | Create LICENSE | Mar 15, 2025 |
| README.md | | README.md | Update README.md | Mar 28, 2025 |
| pyproject.toml | | pyproject.toml | 0.3.0 release | Mar 26, 2025 |
| uv.lock | | uv.lock | 0.3.0 release | Mar 26, 2025 |
| View all files | | |

Repository files navigation

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
no specific installation is needed. We will use uvx
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

Configuration

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

Using uvx

"mcpServers": {
  "git": {
    "command": "uvx",
    "args": [\
        "mcp-server-ida"\
    ]
  }
}

Using pip installation

"mcpServers": {
  "git": {
    "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
   for run instructions.

2. Test using the Claude desktop app. Add the following to your claude_desktop_config.json:

UVX

{
"mcpServers": {
  "git": {
    "command": "uv",
    "args": [ \
      "--directory",\
      "/<path to mcp-server-ida>",\
      "run",\
      "mcp-server-ida"\
    ]
  }
}

Alternatives

ida-pro-mcp

ida-mcp-server-plugin

mcp-server-idapro

pcm

Screenshots

About

A Model Context Protocol server for IDA

Resources

Readme

License

MIT license

Activity

Custom properties

Stars

307 stars

Watchers

4 watching

Forks

34 forks

Report repository

Releases 5

v0.3.4 Latest\
\
Mar 28, 2025

+ 4 releases

Packages 0

No packages published

Contributors 2

• 
  Mx-Iris Mx-Iris

• 
  Kyle-Ye Kyle

Languages

• Python 100.0%

You can’t perform that action at this time.