Information
# 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\`:
## 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": \{
"git": \{
"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
