ph4ntom IDA Bridge 🌉

IDA Pro 9.x के लिए स्वायत्त AI और MCP नियंत्रण परत
IDA Pro को एक एजेंटिक रिवर्स-इंजीनियरिंग पावरहाउस में बदलें। Claude Desktop, Cursor, Antigravity, या कस्टम LLM एजेंट्स को Model Context Protocol (MCP) या उच्च-प्रदर्शन REST API के माध्यम से कनेक्ट करें।

              ┌─────────────────────────────────────────────────────────┐
              │                       IDA Pro 9.x                       │
              │         ph4ntom_ida_bridge.py (102 REST Endpoints)      │
              │         127.0.0.1:13370 (Bearer Token Protected)        │
              └────────────────────────────┬────────────────────────────┘
                                           │ REST / JSON / SSE
          ┌────────────────────────────────┼───────────────────────────────┐
          ▼                                ▼                               ▼
   ┌───────────────┐               ┌───────────────┐               ┌───────────────┐
   │  MCP Server   │               │   CLI / SDK   │               │   AI Agents   │
   │  54 Tools     │               │  `ph4ntom-ida`│               │  Multi-LLM    │
   │  Claude       │               │  Automation   │               │  Gemini       │
   │  Cursor       │               │  Headless     │               │  Ollama       │
   │  Antigravity  │               │  Testing      │               │  Claude / GPT │
   └───────────────┘               └───────────────┘               └───────────────┘

ph4ntom IDA Bridge IDA Pro 9.x के लिए एक localhost-only नियंत्रण परत है। यह एक स्व-निहित IDA प्लगइन, एक JSON REST API, एक Python क्लाइंट, एक CLI, 54 मूल MCP टूल्स, और वैकल्पिक स्टैंडअलोन AI बैकएंड्स को जोड़ता है।

संस्करण 6.2.0 पूर्ण IDA 9.3 संगतता, परमाणु डेटाबेस परिवर्तन, स्थिर-समय टोकन प्रमाणीकरण, SSE कर्सर ट्रैकिंग, और पूर्ण परीक्षण सूट कवरेज लाता है।

⚡ क्विकस्टार्ट: Claude Desktop और Cursor (1-क्लिक MCP सेटअप)

Claude Desktop, Cursor, या किसी भी MCP क्लाइंट को 60 सेकंड में अपने चल रहे IDA Pro इंस्टेंस से कनेक्ट करें:

1. क्लोन करें और इंस्टॉल करें

git clone https://github.com/ph4ntom-rev/ph4ntom-ida-bridge.git
cd ph4ntom-ida-bridge
python -m pip install -e ".[mcp]"

2. IDA Pro में प्लगइन इंस्टॉल करें

python cli.py install-plugin --ida-dir "C:\Program Files\IDA Professional 9.0"

(या ida_plugin/ph4ntom_ida_bridge.py और api_schema.json को सीधे अपनी IDA plugins/ डायरेक्टरी में कॉपी करें)।

3. अपने MCP कॉन्फ़िग में जोड़ें

🟣 Claude Desktop

%APPDATA%\Claude\claude_desktop_config.json (Windows) या ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) को संपादित करें:

{
  "mcpServers": {
    "ida-bridge": {
      "command": "python",
      "args": [
        "C:/path/to/ph4ntom-ida-bridge/mcp_server.py"
      ]
    }
  }
}

💻 Cursor / Windsurf

.cursor/mcp.json या Cursor Settings → MCP में जोड़ें:

{
  "mcpServers": {
    "ida-bridge": {
      "command": "python",
      "args": ["-m", "mcp_server"],
      "cwd": "C:/path/to/ph4ntom-ida-bridge"
    }
  }
}

IDA Pro शुरू करें, सर्वर को टॉगल करने के लिए Ctrl+Shift+A दबाएँ, और अपने AI सहायक को प्रॉम्प्ट करें:

"0x140001000 पर स्थित फ़ंक्शन का निरीक्षण करें। क्रॉस-रेफ़रेंस ट्रेस करें, माइक्रोकोड का विश्लेषण करें, C स्यूडोकोड में डीकंपाइल करें, और अस्पष्ट चरों का नाम बदलकर सार्थक नाम दें।"

⚔️ विकल्पों के साथ तुलना

विशेषता	ph4ntom IDA Bridge	Gepetto / IDAGPT	Hex-Rays Copilot
आर्किटेक्चर	द्वि-दिशात्मक MCP + REST + CLI	एकल प्रॉम्प्ट-रैपर	स्वामित्वपूर्ण UI प्लगइन
टूल संख्या	54 ग्रैन्युलर MCP टूल	1 (डीकंपाइल प्रॉम्प्ट)	निश्चित प्रॉम्प्ट क्रियाएँ
AST और कंट्रोल फ़्लो	पूर्ण ctree AST + माइक्रोकोड IR (0-7)	केवल स्यूडोकोड टेक्स्ट	केवल स्यूडोकोड टेक्स्ट
सुरक्षित म्यूटेशन	रोलबैक के साथ परमाणु बैच म्यूटेशन	केवल टिप्पणी सम्मिलन	UI में सुझाव
लाइव डीबगर	रजिस्टर, स्टैक, मेमोरी, ब्रेकपॉइंट	नहीं	नहीं
डायनामिक निष्पादन	ऑन-द-फ़्लाई IDAPython निष्पादन इंजन	नहीं	नहीं
समर्थित LLM	कोई भी MCP क्लाइंट / Claude / GPT / Gemini / Ollama	केवल OpenAI API	स्वामित्वपूर्ण क्लाउड
सुरक्षा और प्रमाणीकरण	केवल लोकलहोस्ट, 256-बिट टोकन, Owner DACL	खुली सादी API कुंजी	स्वामित्वपूर्ण
IDA Pro 9.3 समर्थन	सत्यापित और पूर्णतः परीक्षित	IDA 9+ पर टूटा हुआ	आधिकारिक

🛠️ MCP टूल संदर्भ (54 टूल और 2 संसाधन)

MCP सर्वर 7 रिवर्स-इंजीनियरिंग डोमेन में 54 उद्देश्य-निर्मित टूल प्रदान करता है:

श्रेणी	टूल	विवरण
🔍 बाइनरी और सेगमेंट	`ping`, `get_binary_info`, `list_segments`, `read_bytes`, `read_vtable`	बाइनरी मेटाडेटा, बिटनेस, अनुमतियाँ, vtable निष्कर्षण
🧩 डीकंपाइलेशन और AST	`decompile`, `get_disassembly`, `get_ctree`, `get_microcode`, `get_local_variables`, `get_function_details`	Hex-Rays C स्यूडोकोड, AST ctree JSON, माइक्रोकोड IR (0=PREOPT से 7=LVARS), प्रोटोटाइप जानकारी
🕸️ कॉलग्राफ़ और Xrefs	`get_xrefs_to`, `get_xrefs_from`, `get_callers`, `get_callees`, `get_call_graph`, `get_basic_blocks`, `get_strings_used`	क्रॉस-रेफ़रेंस, पुनरावर्ती कॉलर ट्री, बेसिक ब्लॉक कंट्रोल फ़्लो
🔎 खोज और अन्वेषण	`search_function`, `search_bytes`, `search_text`, `list_strings`, `list_names`, `list_imports`, `list_exports`	वाइल्डकार्ड बाइट खोज (`??`), आयातित DLL फ़ंक्शन, निर्यात, स्ट्रिंग फ़िल्टरिंग
🏷️ प्रकार और स्ट्रक्ट	`list_structs`, `get_struct`, `list_enums`, `list_types`, `get_type`, `create_type`, `create_struct`	C घोषणा पार्सिंग, संरचना परिभाषाएँ, enum सदस्य निरीक्षण
✏️ डेटाबेस म्यूटेशन	`rename_function`, `comment_function`, `set_inline_comment`, `rename_variable`, `set_variable_type`, `set_function_type`, `patch_bytes`, `batch_mutations`, `undo`, `redo`, `save_database`, `navigate_to`	सत्यापित नामकरण, स्थानीय चर टाइपिंग, बाइनरी पैचिंग, परमाणु रोलबैक
🐞 लाइव डीबगर	`dbg_start`, `dbg_set_breakpoint`, `dbg_continue`, `dbg_step_into`, `dbg_step_over`, `dbg_get_registers`, `dbg_read_memory`, `dbg_get_stack`	प्रक्रिया निष्पादन नियंत्रण, हार्डवेयर ब्रेकपॉइंट, लाइव रजिस्टर और मेमोरी डंप
⚡ डायनामिक IDAPython	`execute_idapython`	संरचित `result` कैप्चर के साथ रीयल-टाइम IDAPython निष्पादन
📦 MCP संसाधन	`ida://info`, `ida://schema`	रीयल-टाइम बाइनरी मेटाडेटा और पूर्ण OpenAPI स्कीमा

🔒 सुरक्षा मॉडल

ब्रिज IDA Pro के भीतर चलता है, जो शक्तिशाली क्षमताएँ प्रदान करता है। संस्करण 6 गहन-रक्षा डिफ़ॉल्ट लागू करता है:

ph4ntom-ida-bridge

सबसे लोकप्रिय