Ida Pro MCP Multiple

🚀 IDA MCP Server Usage Guide

The IDA MCP Server supports parallel analysis of multiple files and multiple sessions. Remember, after connecting via MCP, you'll get 77 tools!

✨ Features

• Support for parallel analysis of multiple files and multiple sessions.
• Provide a total of 77 tools after MCP connection.
• Cross - platform support for Windows, macOS, and Linux.

📦 Installation

Supported Platforms

• ✅ Windows (10/11)
• ✅ macOS (12+)
• ✅ Linux (Ubuntu 20.04+, Debian 11+)

1. Environment Requirements

2. Installation Steps

Windows

# Install uv
pip install uv

# Navigate to the project directory
cd ida-pro-mcp

# Install dependencies
uv sync

macOS

# Method 1: Install uv using the official script
curl -LsSf https://astral.sh/uv/install.sh | sh

# Method 2: Install uv using Homebrew
brew install uv

# Navigate to the project directory
cd ida-pro-mcp

# Install dependencies
uv sync

Linux

# Install uv using the official script
curl -LsSf https://astral.sh/uv/install.sh | sh

# Navigate to the project directory
cd ida-pro-mcp

# Install dependencies
uv sync

3. Configuration File (Recommended)

Edit the config.toml in the root directory. Relative paths are resolved relative to this file:

port = 8746                  # MCP main port
base_session_port = 10000    # Starting port for sessions
analyze_dir = "analyze"      # Directory for pre - loaded PE/ELF/MachO files
ida_dir = ""                 # Optional, IDA installation path; leave empty to use the environment variable IDADIR
uv = "uv"                    # uv executable file
skip_port_check = false      # Skip port check
no_preload = false           # Do not pre - load files, start empty
mcp_dir = "ida-pro-mcp"      # ida-pro-mcp project path

IDA Path Configuration Examples for Each Platform

# Windows
ida_dir = "C:/Program Files/IDA Pro 9.2"

# macOS
ida_dir = "/Applications/IDA Pro 9.2/ida.app/Contents/MacOS"

# Linux
ida_dir = "/opt/ida-9.2"

Override priority: CLI parameters > config.toml > built - in defaults

💻 Usage Examples

4. Usage Methods

Method 1: One - click Cross - platform Startup (Recommended)

Based on the configuration in config.toml, automatically scan the binary files in analyze/ and start:

# Common for Windows / macOS / Linux
python start.py

Custom Parameters

# Windows
python start.py --port 9000 --base-session-port 12000 --analyze-dir ./analyze --ida-dir "C:/Program Files/IDA Pro 9.2"

# macOS (Note that spaces in the path need to be escaped or quoted)
python start.py --port 9000 --ida-dir "/Applications/IDA Pro 9.2/ida.app/Contents/MacOS"

# Linux
python start.py --port 9000 --ida-dir "/opt/ida-9.2"

# Skip port check (start even if the port is occupied)
python start.py --skip-port-check

# Start empty (do not pre - load files, suitable for manual session_create)
python start.py --no-preload

Parameter Description

Method 2: Manual Session Creation

1. Run python start.py --no-preload to start an empty server.
2. Call session_create via MCP to create an analysis session.

📚 Documentation

MCP Configuration

Claude Desktop

Configuration File Location:

Configuration Content:

{
  "mcpServers": {
    "ida-mcp": {
      "transport": {
        "type": "http",
        "url": "http://127.0.0.1:8746/mcp"
      }
    }
  }
}

Cherry Studio

{
  "mcpServers": {
    "ida-mcp": {
      "name": "IDA MCP Server",
      "baseUrl": "http://127.0.0.1:8746/mcp",
      "type": "http"
    }
  }
}

Available Tools

Session Management (6 tools)

Analysis Tools (71 tools)

For the detailed tool list, please refer to AVAILABLE_TOOLS.md

Usage Examples

Create a Session and Analyze

1. session_list - View all sessions
2. session_switch - Switch to the target session
3. lookup_funcs - Find the main function
4. decompile - Decompile the main function

Parameter Examples

// Find a function
{"name": "lookup_funcs", "arguments": {"queries": "main"}}

// Decompile
{"name": "decompile", "arguments": {"addrs": ["0x140001440"]}}

// List functions
{"name": "list_funcs", "arguments": {"queries": {"count": 10, "offset": 0}}}

🔧 Troubleshooting

Port Occupied

Windows

# Check port occupancy
netstat -ano | findstr ":8746"

# Terminate the process
taskkill /F /PID <Process ID>

macOS / Linux

# Check port occupancy
lsof -i :8746

# Terminate the process
kill -9 <PID>

# Or use a single command
lsof -ti :8746 | xargs kill -9

IDB File Locked

Delete files such as .id0, .id1, .id2, .i64 in the analyze/ folder and re - analyze.

Session Creation Failed

1. Check if the IDA path is correct.
2. Confirm that the IDA version >= 9.2.
3. Check the server log output.
4. Confirm that the Python version >= 3.11.

macOS Specific Issues

# If there is a permission issue
chmod +x start.py

# If the uv command is not found
# Method 1: Add to PATH
export PATH="$HOME/.cargo/bin:$PATH"

# Method 2: Use the full path
~/Downloads/ida-pro-mcp/idb/python.exe -m uv sync

Linux Specific Issues

# If dependencies are missing
sudo apt install python3-dev build-essential

# If Python is not found
which python3
python3 --version

Directory Structure

IDA-MCP-Release/
├── analyze/               # Place binary files to be analyzed
│   ├── *.exe             # Windows PE files
│   ├── *.elf / *_elf     # Linux ELF files
│   └── *.bin / *_macho   # macOS MachO files
├── ida-pro-mcp/          # Core of the MCP server
│   ├── .venv/           # Virtual environment
│   └── src/
├── start.py              # Cross - platform one - click startup script
├── config.toml           # Configuration file
├── AVAILABLE_TOOLS.md    # Complete tool list
└── claude_desktop_config.json

Technical Details

Update Log

v2.0.0 (2025-12-30)

• ✅ Fixed the tool loading issue (now correctly shows 77 tools).
• ✅ Fixed the session process lifecycle (using blocking mode).
• ✅ All 71 analysis tools passed the test.
• ✅ Added cross - platform support (Windows/macOS/Linux).
• ✅ Improved error handling and log output.

📄 License

This project is open - sourced under the MIT license.