ida-headless-mcp

Overview

This MCP server bridges IDA Pro with the Model Context Protocol, allowing AI assistants to perform binary analysis tasks. It uses a Go server to manage session registry and worker processes while Python workers handle actual IDA operations via idalib. The architecture supports process isolation, automatic session timeouts, and provides tools for analyzing various binary types including Unity games and Flutter apps. The server supports both streamable HTTP and SSE transports for integration with clients like Claude Desktop and Claude Code.

Try asking AI

After installing, here are 4 things you can ask your AI assistant:

• open_binary

  Opens a binary file in IDA Pro for analysis

  Try:Open the binary at /path/to/sample.soTry:Load the file named malware.exe into IDATry:Start analysis of the target binary
• run_auto_analysis

  Runs automatic analysis on the loaded binary

  Try:Run auto analysis on the current binaryTry:Apply all auto analysis features to this fileTry:Automatically analyze the loaded binary
• get_entry_point

  Retrieves the entry point address of the binary

  Try:Get the entry point addressTry:Where does this binary start executing?Try:Find the entry point
• get_decompiled_func

  Gets the decompiled code of a function at a specific address

  Try:Decompile the function at address 0x12345Try:Show me the decompilation of this functionTry:Get the pseudocode for the function at 0xdeadbeef
• get_functions

  Lists all functions in the binary

  Try:Show me all functions in this binaryTry:List all function definitionsTry:Get the function list with addresses
• close_binary

  Closes the currently open binary

  Try:Close the current binaryTry:Finish analysis and close the fileTry:Unload the binary from IDA
• import_flutter

  Imports Flutter/Dart metadata from unflutter JSON

  Try:Import Flutter metadata from flutter_meta.jsonTry:Add Flutter analysis data to this binaryTry:Apply Flutter metadata from unflutter output
• import_il2cpp

  Imports Il2Cpp metadata from Unity games

  Try:Import Il2Cpp metadata from this Unity binaryTry:Add Il2Cpp analysis data to this fileTry:Apply metadata from Il2CppDumper
• list_sessions

  Lists all active IDA analysis sessions

  Try:Show me all active sessionsTry:List currently open binariesTry:What sessions are active?
• get_strings

  Retrieves all strings found in the binary

  Try:Show me all strings in this binaryTry:Extract all ASCII and Unicode stringsTry:Get all text strings from the file
• get_segments

  Lists all segments/sections in the binary

  Try:Show me all memory segmentsTry:List all sections in this binaryTry:Get the segment layout of the file
• get_comments

  Retrieves all code comments in the binary

  Try:Show me all code commentsTry:Get all analysis commentsTry:List user-defined comments in this binary

Comparable tools

Installation

{
  "mcpServers": {
    "ida-headless": {
      "url": "http://127.0.0.1:17300/",
      "type": "http"
    }
  }
}

./scripts/setup_idalib.sh   # Setup idalib
make install-python         # Install Python dependencies
make build                  # Build Go server

On Hacker News

Recent discussion from the developer community.

• Ida Headless MCP▲ 2
  Story by kugutsumen · 2025-11-14

Compare ida-headless-mcp with