# zboralski/ida-headless-mcp

**Category:** 🔒 Security  
**Repository:** https://github.com/zboralski/ida-headless-mcp  
**GitHub Stars:** 162  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/zboralski-ida-headless-mcp

## Description
Headless IDA Pro binary analysis via MCP. Multi-session concurrency with Go orchestration and Python workers. Supports Il2CppDumper and Blutter metadata import for Unity and Flutter reverse engineering.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `uvx` (confidence: low):

```json
"mcpServers": {
  "ida-headless-mcp": {
    "command": "uvx",
    "args": ["zboralski-ida-headless-mcp"],
    "env": {
      "IDA_MCP_PORT": "",
      "IDA_MCP_SESSION_TIMEOUT_MIN": "",
      "IDA_MCP_MAX_SESSIONS": "",
      "IDA_MCP_WORKER": "",
      "IDA_MCP_DEBUG": ""
    }
  }
}
```

**Requires environment variables:** `IDA_MCP_PORT`, `IDA_MCP_SESSION_TIMEOUT_MIN`, `IDA_MCP_MAX_SESSIONS`, `IDA_MCP_WORKER`, `IDA_MCP_DEBUG` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation
This server enables headless binary analysis using IDA Pro via the Model Context Protocol. It supports concurrent multi-session operation managed by a Go server orchestrating Python workers that handle IDA operations. It includes tools for importing Il2CppDumper metadata for Unity games and unflutter metadata for Flutter/Dart apps, making it suitable for reverse engineering those platforms. Use it to automate and scale IDA analysis workflows programmatically.

**Use cases:**
- Open and analyze binaries headlessly with IDA Pro
- Import Unity Il2Cpp metadata for enhanced reverse engineering
- Import Flutter/Dart metadata to create typed structs and functions
- Run automated analysis and retrieve decompiled functions
- Manage multiple concurrent analysis sessions with isolation

**Key features:**
- Multi-session concurrency with process isolation
- 52 MCP tools for binary analysis
- Automatic configurable session timeouts
- Paginated results with configurable limits
- Il2CppDumper metadata import for Unity games
- unflutter metadata import for Flutter/Dart apps

_Summarized from the repository README — see the link above for the full text._