ida-pro-mcp-xjoker 1.1.0.dev1

Vibe reversing with IDA Pro (enhanced fork)

IDA Pro MCP (Enhanced Fork)

中文文档 | English

An enhanced fork of mrexodia/ida-pro-mcp - MCP Server for LLM-assisted reverse engineering in IDA Pro.

What's Different from Original

Feature	Original	This Fork
Multi-instance Support	❌ Port conflict crashes	✅ Auto port increment (13337→13346)
Web Configuration	❌ None	✅ Bilingual UI at /config.html
API Key Auth	❌ None	✅ Bearer token + env var support
Server Startup	Manual hotkey	✅ Auto-start on IDA launch
Hotkey Conflicts	Occupies Ctrl+Alt+M	✅ No hotkey, menu-only
Config Persistence	None	✅ Saved per IDB database

Key Enhancements

• Port Conflict Auto-Retry: Multiple IDA instances automatically use different ports
• Web Config UI: http://localhost:13337/config.html with English/中文 interface
• API Key Authentication: Secure remote access with Bearer token
• Bug Fixes: Thread safety, regex handling, type parsing errors fixed

Installation

pip install ida-pro-mcp-xjoker
ida-pro-mcp --install

Restart IDA Pro completely after installation.

Quick Start

1. Open a binary in IDA Pro
2. MCP server starts automatically on http://127.0.0.1:13337
3. Configure your MCP client:

# Claude Code
claude mcp add ida-pro-mcp http://127.0.0.1:13337/mcp

# With API Key authentication
claude mcp add --transport http ida-pro-mcp http://127.0.0.1:13337/mcp \
  --header "Authorization: Bearer your-api-key"

4. Open web config at http://127.0.0.1:13337/config.html to customize settings

Requirements

• Python 3.11+
• IDA Pro 8.3+ (9.0 recommended), IDA Free not supported
• Any MCP-compatible client

API Overview

76 MCP Tools including:

Category	Tools
Analysis	decompile, disasm, xrefs_to, callees, basic_blocks, insn_query, xref_query, func_profile
Composite	analyze_function, analyze_batch, analyze_component, survey_binary
Memory	get_bytes, get_string, get_int, patch
Types	declare_type, set_type, infer_types, enum_upsert, type_query, type_inspect
Modify	set_comments, append_comments, rename, patch_asm, define_func, define_code, undefine
Search	find_bytes, find_insns, find_regex
Debug	dbg_* (20+ debugger tools, enable with ?ext=dbg)
Python	py_eval, py_exec_file
Multi-Instance	list_instances, select_instance

11 MCP Resources for read-only access:

• ida://idb/metadata, ida://cursor, ida://structs, ida://xrefs/from/{addr}, etc.

Headless Mode

# SSE transport
ida-pro-mcp --transport http://127.0.0.1:8744/sse

# With idalib (no GUI)
idalib-mcp --host 127.0.0.1 --port 8745 /path/to/binary

Links

• Original Project by mrexodia
• Changelog
• Issues

License

MIT - Same as original project