This project provides a Model Context Protocol (MCP) server designed for interaction and automation with IDA Pro, enabling the use of Large Language Models (LLMs) to read and interpret IDA databases. It targets reverse engineers and security researchers seeking to leverage AI for code analysis and understanding.

How It Works

The server acts as a bridge between IDA Pro and LLMs, facilitating the transfer of database context. It allows LLMs to query and process information from IDA databases, offering a novel approach to reverse engineering by integrating AI-powered analysis directly into the workflow. The idalib mode, currently under development, aims to remove the dependency on the IDA plugin and direct IDA execution for certain functionalities.

Quick Start & Requirements

• Installation:
  • Using uv: No specific installation needed, run directly with uvx mcp-server-ida.
  • Using pip: pip install mcp-server-ida.
• IDA Plugin: Copy ida_mcp_server_plugin.py and the ida_mcp_server_plugin directory to IDA's plugins directory (%APPDATA%\Hex-Rays\IDA Pro\plugins on Windows, $HOME/.idapro/plugins on Linux/macOS).
• Dependencies: Requires IDA Pro 9.0+ for idalib mode.
• Configuration: Add server configuration to claude_desktop_config.json.
• Debugging: Use @modelcontextprotocol/inspector (e.g., npx @modelcontextprotocol/inspector uvx mcp-server-ida). Logs are available at ~/Library/Logs/Claude/mcp*.log.
• Development: Local testing involves running the MCP inspector or configuring Claude Desktop with a local path.

Highlighted Details

• Provides a server for IDA interaction and automation.
• Enables reading IDA databases via Large Language Models.
• idalib mode is under development, aiming to reduce IDA plugin dependency.

Maintenance & Community

The project is in early development, with functionality subject to change. Links to community or roadmap are not provided in the README.

Licensing & Compatibility

The README does not specify a license. Compatibility for commercial use or closed-source linking is not detailed.

Limitations & Caveats

The idalib mode is under development and not yet feature-complete. The project is in early development, and its functionality and available tools are subject to change and expansion.