ida

The IDA MCP Server provides a Model Context Protocol interface to interact with an IDA database using large language models. It exposes tooling to read IDA databases and automate IDA-related tasks without requiring direct manual scripting inside IDA, enabling LLM-assisted analysis and generation of actionable insights from the IDA project. The server is intended to evolve during development, and its available tools may expand or change as features are added. To use it, run the server with the uvx-based command as configured above, then connect to it via the MCP client tooling or Claude/Claude Desktop integration to issue model-context operations against your IDA data.

Usage typically involves starting the server and using the MCP inspector or Claude integration to send prompts that request IDA data reads, cross-reference generation, or automation tasks (e.g., querying function signatures, cross-references, or data-flow extraction). The inspector can help debug your server interactions, and the development workflow supports testing changes locally by running the inspector against the local mcp-server-ida instance.

Prerequisites:

• Python (recommended) and/or uv runtime for the uvx workflow
• Node.js is optional if you prefer MCP inspector tooling that requires npm (not mandatory for uvx-based usage)
• Optional: access to an IDA installation if you plan to integrate the IDA plugin workflow locally

Installation options:

1. Install via uvx (recommended):

   • Ensure uv and uvx are installed according to the uv documentation.
   • The server is available as mcp-server-ida and is run via uvx directly, no extra installation is required beyond having the package available in your environment.

2. Install via Python (pip):

   • Install the package from PyPI:

     pip install mcp-server-ida
     

   • Run the server as a module:

     python -m mcp_server_ida
     

3. IDA-side plugin setup (optional for IDA integration):

   • Copy repository/plugin/ida_mcp_server_plugin.py and the repository/plugin/ida_mcp_server_plugin directory into your IDA plugin directory.
   • Plugin location examples:
     • Windows: %APPDATA%\Hex-Rays\IDA Pro\plugins
     • Linux/macOS: $HOME/.idapro/plugins

4. Configuration example (Claude Desktop):

   • For uvx-based runs, configure mcpServers in claude_desktop_config.json as shown in the examples:

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

Notes and tips:

• The project is in early development; expect changes to available tools and commands.
• If you plan to test locally, you can use the MCP inspector to connect to the uvx-based server as described in the debugging section of the README.
• The IDA-side plugin workflow is optional but recommended if you intend to invoke IDA functionality directly from within IDA.
• If you encounter logs or debugging issues, tail your local Claude/mcp log files as indicated in the debugging instructions to isolate problems.
• The config examples show how to expose the server under the ida key; you can adapt the server name as needed for multi-server setups.