271 MCP टूल्स — किसी भी प्रतिस्पर्धी कार्यान्वयन से 3 गुना अधिक। सिर्फ पढ़ने के संचालन नहीं — नाम बदलने, टाइप करने, टिप्पणी करने, संरचना निर्माण, स्क्रिप्ट निष्पादन, पी-कोड एमुलेशन और लाइव डिबगिंग के लिए पूर्ण लेखन पहुंच।
युद्ध-परीक्षित AI वर्कफ़्लो — सैकड़ों फ़ंक्शनों में परिष्कृत प्रलेखित वर्कफ़्लो (V5)। चरण-दर-चरण संकेत, हंगेरियन नोटेशन संदर्भ, बैच प्रोसेसिंग गाइड और अनाथ कोड खोज शामिल हैं।
प्रोडक्शन-ग्रेड विश्वसनीयता — परमाणु लेनदेन, बैच संचालन (93% API कॉल में कमी), कॉन्फ़िगरेबल टाइमआउट और सुरुचिपूर्ण त्रुटि हैंडलिंग। कोई मूक विफलता नहीं।
क्रॉस-बाइनरी दस्तावेज़ीकरण स्थानांतरण — SHA-256 फ़ंक्शन हैश मिलान स्वचालित रूप से बाइनरी संस्करणों में दस्तावेज़ीकरण प्रसारित करता है। एक बार दस्तावेज़ीकृत करें, हर जगह लागू करें।
पूर्ण घिड्रा सर्वर एकीकरण — साझा घिड्रा सर्वर से कनेक्ट करें, रिपॉजिटरी प्रबंधित करें, संस्करण नियंत्रण, चेकआउट/चेकइन वर्कफ़्लो और बहु-उपयोगकर्ता सहयोग।
हेडलेस और GUI मोड — घिड्रा GUI के साथ या बिना चलाएं। CI/CD पाइपलाइनों और बड़े पैमाने पर स्वचालित विश्लेषण के लिए डॉकर-रेडी।
डिज़ाइन द्वारा परिप्रेक्ष्यपूर्ण — v5.0 नामकरण परंपराओं, प्रकार सुरक्षा और दस्तावेज़ीकरण मानकों को टूल लेयर में स्थानांतरित करता है। AI एजेंट और मानव इंजीनियर हर प्रॉम्प्ट में स्टाइल गाइड के बिना सुसंगत आउटपुट उत्पन्न करते हैं।

स्तर	व्यवहार	उदाहरण
स्वचालित-सुधार	चुपचाप लागू किया गया	`uint32` पर `count` फ़ील्ड → सेव पर स्वचालित रूप से उपसर्ग `dwCount`
चेतावनी	परिवर्तन होता है, चेतावनी वापस की जाती है	`processData` → "नाम क्रिया के साथ PascalCase होना चाहिए: `ProcessData`"
अस्वीकार	परिवर्तन स्पष्टीकरण के साथ अवरुद्ध	`undefined → undefined` प्रकार परिवर्तन → "कोई-ऑप अस्वीकृत, प्रकार अपरिवर्तित"

अनुशंसित: पहले environment preflight चलाएं: ```text python -m tools.setup preflight --ghidra-path "F:\ghidra_12.1.2_PUBLIC"
बनाएं और Ghidra में तैनात करें: ```text python -m tools.setup ensure-prereqs --ghidra-path "F:\ghidra_12.1.2_PUBLIC" python -m tools.setup build python -m tools.setup deploy --ghidra-path "F:\ghidra_12.1.2_PUBLIC"

वैकल्पिक सख्त/मैन्युअल मोड (उन्नत): ```text
Skip automatic prerequisite setup
python -m tools.setup build python -m tools.setup deploy --ghidra-path "F:\ghidra_12.1.2_PUBLIC"
कमांड सहायता दिखाएँ: ```text python -m tools.setup --help
वैकल्पिक केवल-निर्माण मोड (उन्नत/समस्या निवारण): ```text python -m tools.setup build

## 1.4. समर्थन

यह उपकरण जैसा है वैसा ही प्रदान किया जाता है। समस्याओं, सुविधा अनुरोधों या योगदान के लिए, कृपया GitHub Issues और Pull Requests का उपयोग करें।

## 1.5. लाइसेंस

यह परियोजना MIT License के अंतर्गत लाइसेंस प्राप्त है - विस्तार के लिए [LICENSE](https://github.com/bethington/ghidra-mcp/blob/main/LICENSE) फ़ाइल देखें।

## 1.6. आभार

खुले-स्रोत समुदाय और उन सभी योगदानकर्ताओं को विशेष धन्यवाद जिन्होंने परीक्षण, प्रतिक्रिया और कोड योगदान के माध्यम से इस उपकरण को बेहतर बनाने में मदद की।   ```bash
# Secondary/manual Gradle build path only (not used by tools.setup or VS Code tasks)
GHIDRA_INSTALL_DIR=/path/to/ghidra gradle buildExtension

रिपॉजिटरी क्लोन करें: ```bash git clone https://github.com/bethington/ghidra-mcp.git cd ghidra-mcp
सिस्टम आवश्यकताएँ स्थापित करें (यदि पहले से स्थापित नहीं हैं): ```bash sudo apt update && sudo apt install -y openjdk-21-jdk maven python3 python3-pip python3-venv curl jq unzip

Debian/Kali/Ubuntu 23.04+ नोट (PEP 668): ये डिस्ट्रोस सिस्टम Python को बाह्य रूप से प्रबंधित चिह्नित करते हैं, इसलिए एक सादा pip install error: externally-managed-environment के साथ विफल होता है। --break-system-packages के साथ इसके आसपास काम न करें — यह apt-प्रबंधित उपकरणों को दूषित कर सकता है। इसके बजाय uv का उपयोग करें (अनुशंसित — यह स्वचालित रूप से एक परियोजना-स्थानीय .venv बनाता और प्रबंधित करता है, और यही इस रेपो के कमांड उपयोग करते हैं):
curl -LsSf https://astral.sh/uv/install.sh | sh
uv run bridge-mcp-ghidra    # resolves deps into .venv and starts the bridge
या एक क्लासिक वर्चुअल एनवायरनमेंट:
python3 -m venv .venv && source .venv/bin/activate
pip install -e .
bridge-mcp-ghidra

पर्यावरण प्रीफ्लाइट चलाएं: ```bash python -m tools.setup preflight --ghidra-path ~/ghidra_12.1.2_PUBLIC
Ghidra पर बनाएँ और तैनात करें (एकल कमांड): ```bash python -m tools.setup ensure-prereqs --ghidra-path ~/ghidra_12.1.2_PUBLIC python -m tools.setup build python -m tools.setup deploy --ghidra-path ~/ghidra_12.1.2_PUBLIC

वैकल्पिक: केवल Maven निर्भरताएँ सेटअप करें: ```bash python -m tools.setup install-ghidra-deps --ghidra-path ~/ghidra_12.1.2_PUBLIC
कमांड सहायता दिखाएँ: ```bash python -m tools.setup --help

पूर्वापेक्षाएँ स्थापित करें: ```bash brew install openjdk@21 maven python ghidra
रिपॉज़िटरी को क्लोन करें: ```bash git clone https://github.com/bethington/ghidra-mcp.git cd ghidra-mcp
Ghidra JARs को local Maven में स्थापित करें: ```bash python -m tools.setup install-ghidra-deps
--ghidra-path /opt/homebrew/opt/ghidra/libexec
निर्माण और तैनाती: ```bash python -m tools.setup ensure-prereqs
--ghidra-path /opt/homebrew/opt/ghidra/libexec python -m tools.setup build python -m tools.setup deploy
--ghidra-path /opt/homebrew/opt/ghidra/libexec

कर्सर/क्लॉड MCP कॉन्फ़िगर करें (~/.cursor/mcp.json): ```json { "mcpServers": { "ghidra": { "command": "uv", "args": ["run", "--directory", "/path/to/ghidra-mcp", "bridge-mcp-ghidra"] } } }

### मूल उपयोग

#### विकल्प 1: Stdio परिवहन (AI उपकरणों के लिए अनुशंसित)```bash
uv run bridge-mcp-ghidra          # or: python -m bridge_mcp_ghidra

Add `--scope project` को `ghidra` से पहले जोड़ें ताकि सर्वर को आपके उपयोगकर्ता कॉन्फ़िगरेशन के बजाय वर्तमान प्रोजेक्ट के `.autohand` कॉन्फ़िगरेशन में सहेजा जा सके।

#### विकल्प 2: स्ट्रीमेबल HTTP ट्रांसपोर्ट (वेब/HTTP क्लाइंट के लिए अनुशंसित)```bash
uv run bridge-mcp-ghidra --transport streamable-http --mcp-host 127.0.0.1 --mcp-port 8081

ब्राउज़र-आधारित क्लाइंट (उदा., [MCP Inspector](https://github.com/modelcontextprotocol/inspector)) बिना किसी अतिरिक्त कॉन्फ़िगरेशन के काम करते हैं: HTTP ट्रांसपोर्ट CORS प्रीफ़्लाइट (`OPTIONS`) अनुरोधों का उत्तर देते हैं और `mcp-session-id` / `mcp-protocol-version` हेडर को स्क्रिप्ट्स के लिए उजागर करते हैं। अनुमत मूल Host-हेडर नीति को दर्शाते हैं — किसी भी पोर्ट पर लूपबैक हमेशा अनुमत होता है, साथ ही बाइंड होस्ट और `GHIDRA_MCP_ALLOWED_HOSTS` में सूचीबद्ध कोई भी होस्ट।

#### विकल्प 3: SSE ट्रांसपोर्ट (अब अप्रचलित — इसके बजाय streamable-http का उपयोग करें)```bash
uv run bridge-mcp-ghidra --transport sse --mcp-host 127.0.0.1 --mcp-port 8081

फ़्लैग	डिफ़ॉल्ट	विवरण
`--transport`	`stdio`	`stdio` (AI उपकरण), `streamable-http` (वेब क्लाइंट), `sse` (अप्रचलित)
`--mcp-host`	`127.0.0.1`	HTTP ट्रांसपोर्ट के लिए होस्ट बांधें
`--mcp-port`	—	HTTP ट्रांसपोर्ट के लिए पोर्ट
`--lazy`	बंद	केवल डिफ़ॉल्ट टूल समूहों को कनेक्ट करने पर लोड करें। तेज़ स्टार्टअप, लेकिन MCP क्लाइंट जो `tools/list_changed` का समर्थन नहीं करते, उन्हें अधूरा टूल सूची दिखाई देगी। Claude Code के लिए अनुशंसित नहीं है।
`--no-lazy`	(डिफ़ॉल्ट)	कनेक्ट करने पर सभी टूल समूहों को तुरंत लोड करें। अधिकांश AI क्लाइंट के लिए आवश्यक।
`--default-groups`	`listing,function,program`	अल्पविराम से अलग किए गए समूह जो `--lazy` सेट होने पर कनेक्ट करने पर लोड होते हैं।

इसके बिना, `program=` को छोड़ने वाला कॉल वर्तमान प्रोग्राम के विरुद्ध चलता है, जो एकल-प्रोग्राम कार्यप्रवाह के लिए ठीक है लेकिन एक बार कई प्रोग्राम खुले होने पर खतरनाक हो जाता है: कॉल बिना किसी त्रुटि के गलत बाइनरी को पढ़ या संपादित कर सकता है। जब एक से अधिक क्लाइंट एक सर्वर साझा करते हैं तो खतरा और भी बदतर होता है, क्योंकि प्रत्येक क्लाइंट उस current-program ग्लोबल को दूसरों के नीचे से हटा देता है।

सख्त मोड चालू होने पर, प्रत्येक प्रोग्राम-स्कोप्ड कॉल को अपने लक्ष्य का नाम बताना होगा। यह उन सभी चयनकर्ताओं को कवर करता है जो एक खुले प्रोग्राम को चुनते हैं: सादा `program=` और क्रॉस-प्रोग्राम टूल्स के `source_program`/`target_program` या `program_a`/`program_b` (आवश्यक घोषित, लेकिन सर्वर अभी भी वर्तमान प्रोग्राम पर वापस आ जाता है जब एक खाली आता है)। भूला हुआ चयनकर्ता गलत बाइनरी में मौन लेखन के बजाय पहली बुरी कॉल पर एक तेज़ त्रुटि के रूप में सामने आता है। बिना प्रोग्राम चयनकर्ता वाले उपकरण (`open_program` और `close_program` `path`/`name` लेते हैं) अप्रभावित रहते हैं। डिफ़ॉल्ट रूप से बंद: चर अनसेट होने पर ब्रिज कॉल अपरिवर्तित भेजता है।

#### टूल-कॉन्टेक्स्ट ओवरहेड को कम करना

ब्रिज एक बड़ी सूची प्रस्तुत करता है। मॉडल के टूल सतह को छोटा रखने के लिए, `--lazy` के साथ चलाएं (कनेक्ट होने पर केवल `listing,function,program` लोड करता है) और मॉडल को सब कुछ पंजीकृत करने के बजाय मांग पर बाकी की **खोज** करने दें:

- `search_tools("rename function")` — **संपूर्ण** सूची में कीवर्ड खोज, जिसमें वे उपकरण शामिल हैं जिनका समूह लोड नहीं है। प्रत्येक परिणाम बताता है कि क्या यह अभी कॉल करने योग्य है और यदि नहीं, तो इसे सक्षम करने के लिए सटीक `load_tool_group(...)` कॉल।
- `list_tool_groups()` — सभी श्रेणियों और उनकी लोड स्थिति को सूचीबद्ध करें।
- `load_tool_group("datatype")` / `unload_tool_group("datatype")` — रनटाइम पर एक श्रेणी लोड या हटाएं।
- `check_tools("rename_or_label,batch_set_comments")` — पुष्टि करें कि विशिष्ट उपकरण अभी कॉल करने योग्य हैं।

`search_tools` उत्सुक और `--lazy` दोनों मोड में काम करता है, इसलिए `tools/list_changed` का सम्मान करने वाले एजेंटों को अग्रिम संदर्भ लागत के बिना पूरी खोज मिलती है।

#### वैकल्पिक: स्टैंडअलोन डिबगर सर्वर प्रारंभ करें```bash
uv sync --group debugger
uv run python -m debugger

फ़्लैग	डिफ़ॉल्ट	विवरण
`--port`	`8099`	HTTP सर्वर पोर्ट
`--host`	`127.0.0.1`	बाइंड पता (`0.0.0.0` LAN पर एक्सपोज़ करने के लिए)
`--exports-dir`	—	ऑर्डिनल-टू-नेम रिज़ॉल्यूशन के लिए `dll_exports/` निर्देशिका का पथ
`--log-level`	`INFO`	`DEBUG`, `INFO`, `WARNING`, या `ERROR`

## इस परियोजना को समर्थन दें

यदि Ghidra MCP आपका इंजीनियरिंग या रिवर्स-इंजीनियरिंग का समय बचाता है, तो कृपया [परियोजना को प्रायोजित करने](https://github.com/sponsors/bethington) पर विचार करें।

- एकमुश्त प्रायोजन बग फिक्स, संगतता अपडेट और रिलीज़ कार्य के लिए धन जुटाने में मदद करता है।
- आवर्ती प्रायोजन रखरखाव, दस्तावेज़ीकरण और उत्पादन सख्तीकरण को जारी रखने में मदद करता है।
- कंपनी का समर्थन ब्रिज, हेडलेस सर्वर, डीबगर एकीकरण और वर्कफ़्लो टूलिंग के लिए दीर्घकालिक विश्वसनीयता को प्राथमिकता देने में मदद करता है।

## 🔒 सुरक्षा

GhidraMCP को **केवल localhost विकास** के लिए डिज़ाइन किया गया है। डिफ़ॉल्ट कॉन्फ़िगरेशन — HTTP सर्वर `127.0.0.1` से बंधा हुआ, बिना प्रमाणीकरण — एक विश्वसनीय एकल-उपयोगकर्ता वर्कस्टेशन पर सुरक्षित है और v5.4.1 से पहले के व्यवहार से मेल खाता है।

**यदि आप सर्वर को लूपबैक से आगे उजागर करते हैं, तो पहले इन तीन पर्यावरण चर को कॉन्फ़िगर करें।** बिना टोकन के गैर-लूपबैक बाइंड पर सर्वर शुरू होने से मना कर देता है।

| Env var | प्रभाव |
|---|---|
| `GHIDRA_MCP_AUTH_TOKEN` | जब सेट किया जाता है, तो हर HTTP अनुरोध को `Authorization: Bearer <token>` ले जाना चाहिए। समय-सुरक्षित तुलना। `/mcp/health`, `/health`, `/check_connection` को छूट दी गई है। |
| `GHIDRA_MCP_ALLOW_SCRIPTS` | `/run_script_inline` और `/run_ghidra_script` को सक्षम करने के लिए `1`, `true`, या `yes` पर सेट करें। **v5.4.1 से डिफ़ॉल्ट रूप से बंद** — ये एंडपॉइंट Ghidra प्रक्रिया के विरुद्ध मनमाना Java निष्पादित करते हैं। हेडलेस मोड में यह सर्वर स्टार्टअप पर OSGi `BundleHost` प्रारंभ (Felix framework, ~सैकड़ों ms) को भी ट्रिगर करता है; यदि आपको स्क्रिप्ट निष्पादन की आवश्यकता नहीं है तो इसे बंद छोड़ दें। |
| `GHIDRA_MCP_FILE_ROOT` | जब किसी निर्देशिका पथ पर सेट किया जाता है, तो फ़ाइलसिस्टम-पथ एंडपॉइंट (`/load_program`, `/import_file`, `/open_project`, `/delete_file`, आदि) इनपुट को कैननिकलाइज़ करते हैं और इसे इस रूट के अंतर्गत आने की आवश्यकता होती है। पथ-ट्रैवर्सल को रोकता है। |

नाम-गुणवत्ता प्रवर्तन सुरक्षा से अलग है। डिफ़ॉल्ट रूप से,
`rename_function_by_address` और वैश्विक लेखन एंडपॉइंट उन नामों को अस्वीकार करते हैं जो
अंतर्निहित गुणवत्ता गेट में विफल होते हैं, और स्ट्रक्चर फ़ील्ड लेखन अंतर्निहित
फ़ील्ड उपसर्ग परंपरा को लागू करते हैं। **Edit > Tool
Options > GhidraMCP HTTP Server > Strict Naming Enforcement** के साथ अंतर्निहित परंपरा परत को अक्षम करें। वही Tool Options
चेकबॉक्स `rename_data`, `rename_global_variable`,
`set_global`, `apply_data_type` उपसर्ग/प्रकार गार्ड, और स्ट्रक्चर-फ़ील्ड
हंगेरियन उपसर्ग ऑटो-फिक्स को `create_struct`, `add_struct_field`, और
`modify_struct_field` में शामिल करता है। यह सेटिंग MCP सर्वर शुरू होने या
पुनरारंभ होने पर पढ़ी जाती है। जब प्रवर्तन अक्षम किया जाता है, तब भी फ़ंक्शन/ग्लोबल
परंपरा चेतावनियाँ वापस की जाती हैं।

### उदाहरण: प्रमाणीकरण के साथ एक निजी LAN को उजागर करना```bash
export GHIDRA_MCP_AUTH_TOKEN=$(openssl rand -hex 32)
export GHIDRA_MCP_ALLOW_SCRIPTS=1     # only if your workflow needs it
export GHIDRA_MCP_FILE_ROOT=/srv/ghidra/inputs

java -jar GhidraMCPHeadless.jar --bind 0.0.0.0 --port 8089

सुनिश्चित करें कि आपने सर्वर प्रारंभ किया: Tools > GhidraMCP > Start MCP Server
कॉन्फ़िगर किया गया पोर्ट जांचें: Edit > Tool Options > GhidraMCP HTTP Server
जांचें कि पोर्ट उपयोग में है या नहीं: ```bash
Linux/macOS
lsof -i :8089
Windows
netstat -ano | findstr :8089
Ghidra कंसोल में त्रुटियों की जाँच करें: Window > Console

यदि आपके पास एक वैश्विक Python और एक प्रोजेक्ट venv दोनों हैं, तो सुनिश्चित करें कि आप एक ही इंटरप्रेटर में इंस्टॉल करें और चलाएं।

### 500 आंतरिक सर्वर त्रुटियाँ

**कारण:** सर्वर-साइड अपवाद, अक्सर प्रोग्राम डेटा की कमी के कारण।

**समाधान:**
1. सुनिश्चित करें कि CodeBrowser में एक बाइनरी लोड की गई है
2. पहले स्वचालित विश्लेषण चलाएँ: **Analysis > Auto Analyze**
3. Java अपवादों के लिए Ghidra कंसोल (**Window > Console**) जाँचें
4. कुछ संचालनों के लिए पूरी तरह से विश्लेषित बाइनरी आवश्यक है

### 404 नहीं मिला त्रुटियाँ

**कारण:** एंडपॉइंट मौजूद नहीं है या गलत URL है।

**समाधान:**
1. एंडपॉइंट की उपस्थिति सत्यापित करें: `curl http://127.0.0.1:8089/get_version`
2. एंडपॉइंट नाम में टाइपो की जाँच करें
3. सुनिश्चित करें कि आप सही HTTP विधि (GET बनाम POST) का उपयोग कर रहे हैं

### Python Ghidra स्क्रिप्ट्स "No script provider found" से विफल होती हैं

**कारण:** Ghidra 12.1.2 में, Jython समर्थन अब डिफ़ॉल्ट रूप से सक्षम नहीं है।
`.py` स्क्रिप्ट्स को बंडल Jython एक्सटेंशन की आवश्यकता होती है; Python 3
स्क्रिप्ट्स को Ghidra Script Manager के बजाय PyGhidra का उपयोग करना चाहिए।

**समाधान:**
1. Ghidra Front End में, **File > Install Extensions** खोलें।
2. **Jython** चेक करें, Ghidra को पुनरारंभ करें, फिर Script Manager को रिफ्रेश करें।
3. नए ऑटोमेशन के लिए, Java Ghidra स्क्रिप्ट्स या PyGhidra को प्राथमिकता दें।

### एक्सटेंशन Install Extensions में दिखाई नहीं दे रहा है

**कारण:** JAR फ़ाइल गलत स्थान पर है।

**समाधान:**
1. मैन्युअल इंस्टॉल स्थान: `~/.ghidra/ghidra_12.1.2_PUBLIC/Extensions/GhidraMCP/lib/GhidraMCP.jar`
2. या उपयोग करें: **File > Install Extensions > Add** और ZIP फ़ाइल चुनें
3. सुनिश्चित करें कि JAR/ZIP आपके Ghidra संस्करण के लिए बनाया गया था

### बिल्ड "Ghidra dependencies not found" से विफल होता है

**कारण:** Ghidra JARs स्थानीय Maven रिपॉजिटरी में स्थापित नहीं हैं।

**समाधान:**```text
# Windows (recommended)
python -m tools.setup install-ghidra-deps --ghidra-path "C:\ghidra_12.1.2_PUBLIC"

analysis_status - खुले प्रोग्राम के लिए ऑटो-विश्लेषण स्थिति प्राप्त करें
close_program - प्रोजेक्ट पथ या नाम द्वारा एक खुले प्रोग्राम को बंद करें
create_property_map - पते द्वारा कुंजीबद्ध टाइप किए गए मानों को संग्रहीत करने के लिए एक उपयोगकर्ता गुण मानचित्र बनाएं
delete_property_map - एक उपयोगकर्ता गुण मानचित्र और उसमें मौजूद सभी मानों को हटाएं
exit_ghidra - Ghidra को सहेजें और बाहर निकलें
get_address_spaces - प्रोग्राम में सभी भौतिक और ओवरले पता स्थानों की सूची बनाएं (ओवरले में is_overlay फ्लैग और overlayed_space नाम शामिल है)
get_current_program_info - वर्तमान प्रोग्राम जानकारी प्राप्त करें
get_language_metadata - प्रोग्राम का भाषा विवरण डंप करें: पता स्थान, रजिस्टर, डिफ़ॉल्ट प्रतीक, एंडियननेस, पॉइंटर आकार (मुद्दा #192)
get_program_options - प्रकार, वर्तमान मान, डिफ़ॉल्ट और विवरणों के साथ एक प्रोग्राम विकल्प समूह में सभी विकल्प पढ़ें
get_property - एक गुण मानचित्र में एक पते पर संग्रहीत मान पढ़ें
import_file - डिस्क से एक बाइनरी फ़ाइल को वर्तमान Ghidra प्रोजेक्ट में आयात करें और इसे खोलें
list_open_programs - खुले प्रोग्रामों की सूची बनाएं
list_option_groups - प्रोग्राम विकल्प समूहों की सूची बनाएं (जैसे,
list_properties - पेजिनेशन के साथ एक गुण मानचित्र में संग्रहीत (पता, मान) प्रविष्टियों की सूची बनाएं
list_property_maps - उपयोगकर्ता-परिभाषित गुण मानचित्रों की सूची बनाएं — प्रति-पता कुंजी→मान भंडार
open_program - प्रोजेक्ट से प्रोग्राम खोलें
reanalyze - एक प्रोग्राम पर पूर्ण ऑटो-विश्लेषण ट्रिगर करें
remove_program_option - एक प्रोग्राम विकल्प समूह से एक विकल्प हटाएं
remove_property - एक गुण मानचित्र में एक एकल पते पर संग्रहीत मान को हटाएं
save_all_programs - सभी खुले प्रोग्रामों को सहेजें
save_program - वर्तमान प्रोग्राम को सहेजें
set_image_base - प्रोग्राम का आधार पता सेट करें (सभी पतों को रीबेस करता है)
set_program_option - एक टाइप किया गया प्रोग्राम विकल्प सेट करें
set_property - एक गुण मानचित्र में एक पते पर एक मान सेट करें
switch_program - वर्तमान प्रोग्राम स्विच करें

archive_project - वर्तमान में खुले प्रोजेक्ट को Ghidra-मूल .gar फ़ाइल में संग्रहित करें
checkin_program - एक खुले प्रोग्राम को साझा Ghidra सर्वर में एक नए संस्करण के रूप में वापस चेक इन करें
close_project - वर्तमान में खुले प्रोजेक्ट को बंद करें
create_project - एक नया Ghidra प्रोजेक्ट बनाएं
export_program - एक खुले या प्रोजेक्ट-निवासी प्रोग्राम को Ghidra ज़िप फ़ाइल (.gzf) में निर्यात करें
get_project_info - वर्तमान में खुले प्रोजेक्ट के बारे में जानकारी प्राप्त करें
import_program - एक Ghidra ज़िप फ़ाइल (.gzf) को वर्तमान में खुले प्रोजेक्ट में target_folder (डिफ़ॉल्ट '/') के अंतर्गत एक नई DomainFile के रूप में आयात करें
load_program - विश्लेषण के लिए हेडलेस सर्वर में एक बाइनरी फ़ाइल लोड करें
load_program_from_project - Ghidra प्रोजेक्ट से प्रोग्राम लोड करें (हेडलेस)
open_project - एक मौजूदा Ghidra प्रोजेक्ट (.gpr फ़ाइल या निर्देशिका) खोलें
restore_project - एक Ghidra .gar संग्रह को parent_dir/project_name पर एक नए डिस्क-आधारित प्रोजेक्ट में पुनर्स्थापित करें
server_status - हेडलेस सर्वर कनेक्शन स्थिति जांचें

add_function_tag - एक या अधिक टैग को एक फ़ंक्शन से संलग्न करें
batch_add_function_tags - एक लेनदेन में कई फ़ंक्शनों में टैग संलग्न करें
batch_remove_function_tags - एक लेनदेन में कई फ़ंक्शनों से टैग अलग करें
clear_flow_and_repair - एक सीड श्रेणी पर Ghidra का GUI 'क्लियर फ्लो और मरम्मत' क्रिया चलाएं: सीड से पहुंचने योग्य निर्देश प्रवाह को साफ करता है, फिर फ़ंक्शन निकायों की मरम्मत करता है और बनाए रखे गए प्रवाह को पुनः डिसअसेम्बल करता है (clear_data=false, clear_labels=false, repair=true के साथ ClearFlowAndRepairCmd)
create_function_tag - एक वैकल्पिक टिप्पणी के साथ एक प्रोग्राम-व्यापी फ़ंक्शन टैग परिभाषा बनाएं
delete_function_tag - एक प्रोग्राम-व्यापी फ़ंक्शन टैग परिभाषा हटाएं
get_function_tags - एक विशिष्ट फ़ंक्शन को निर्दिष्ट सभी टैग सूचीबद्ध करें
list_class_members - C++ क्लास के सदस्य फ़ंक्शन सूचीबद्ध करें
list_function_tags - उनके उपयोग गणना के साथ सभी प्रोग्राम-व्यापी फ़ंक्शन टैग परिभाषाएँ सूचीबद्ध करें
remove_function_tag - एक फ़ंक्शन से एक या अधिक टैग अलग करें
search_functions_by_tag - सभी फ़ंक्शन सूचीबद्ध करें जिनमें एक निर्दिष्ट टैग संलग्न है
set_decompiler_variable_type - नाम से एक डिकम्पाइलर (उच्च-स्तरीय) चर या पैरामीटर प्रकार सेट करें
set_function_no_return - नो-रिटर्न विशेषता सेट करें
set_function_tag_comment - एक मौजूदा प्रोग्राम-व्यापी फ़ंक्शन टैग पर टिप्पणी/विवरण अद्यतन करें
set_function_this_type - अंतर्निहित 'this' पॉइंटर का डिकम्पाइलर/डेटाबेस प्रकार सेट करें (x86 __thiscall/__fastcall पर ECX)
set_variables - परमाणु रूप से कई चरों के लिए प्रकार और नाम सेट करें

add_struct_field - स्ट्रक्ट फ़ील्ड जोड़ें
analyze_global_completeness - एक वैश्विक चर के दस्तावेज़ीकरण पूर्णता को एक बजटीय 0-100 पैमाने पर स्कोर करें — analyze_function_completeness का डेटा-पता एनालॉग
apply_data_type - डेटा प्रकार लागू करें
audit_global - एक वैश्विक चर की दस्तावेज़ीकरण स्थिति का ऑडिट करें
audit_globals_in_function - एक कॉल में एक फ़ंक्शन के भीतर से संदर्भित प्रत्येक वैश्विक चर का ऑडिट करें
batch_set_variable_types - एकाधिक चर प्रकार सेट करें
clone_data_type - डेटा प्रकार क्लोन करें
create_array_type - सारणी प्रकार बनाएं
create_data_type_category - डेटा प्रकार श्रेणी बनाएं
create_enum - गणना बनाएं
create_function_signature - फ़ंक्शन हस्ताक्षर प्रकार बनाएं
create_pointer_type - पॉइंटर प्रकार बनाएं
create_struct - संरचना बनाएं
create_typedef - typedef बनाएं
create_union - यूनियन बनाएं
delete_data_type - डेटा प्रकार हटाएं
embed_struct_field - एक संरचना फ़ील्ड को मान द्वारा एक एम्बेडेड स्ट्रक्ट प्रकार से बदलें (जैसे,
get_data_type_size - डेटा प्रकार आकार बाइट्स में प्राप्त करें
get_type_size - डेटा प्रकार आकार और जानकारी प्राप्त करें
import_data_types - GDT से डेटा प्रकार आयात करें
list_data_type_categories - डेटा प्रकार श्रेणियाँ सूचीबद्ध करें
list_data_types - डेटा प्रकार सूचीबद्ध करें
modify_struct_field - स्ट्रक्ट फ़ील्ड संशोधित करें
modify_struct_field_type - नाम या ऑफ़सेट (offset:N) द्वारा एक संरचना फ़ील्ड का प्रकार सेट करें
move_data_type_to_category - डेटा प्रकार को श्रेणी में ले जाएं
recreate_struct - एक चरण में एक संरचना बदलें: वैकल्पिक रूप से एक मौजूदा समान-नाम वाले प्रकार को हटाएं, फिर फ़ील्ड JSON के साथ बनाएं (create_struct के समान आकार)
remove_struct_field - स्ट्रक्ट फ़ील्ड हटाएं
resize_struct - कुल बाइट आकार द्वारा एक मौजूदा संरचना को बढ़ाएं या घटाएं
resolve_duplicate_type - सरल नाम से डुप्लिकेट डेटा प्रकार खोजें; जब एक बड़ा विहित प्रकार मौजूद हो तो अप्रयुक्त /Demangler आकार-1 स्टब्स हटाएं
set_function_prototype - फ़ंक्शन प्रोटोटाइप सेट करें (रिटर्न प्रकार, पैरामीटर प्रकार, कॉलिंग कन्वेंशन)
set_global - परमाणु रूप से एक वैश्विक चर पर नाम + प्रकार + प्लेट-टिप्पणी + सारणी लंबाई लागू करें
set_local_variable_type - चर प्रकार सेट करें
set_parameter_type - पैरामीटर प्रकार सेट करें
set_variable_storage - चर भंडारण सेट करें
validate_data_type - डेटा प्रकार सिंटैक्स मान्य करें
validate_data_type_exists - जांचें कि क्या डेटा प्रकार मौजूद है
validate_function_prototype - फ़ंक्शन प्रोटोटाइप मान्य करें

analyze_api_call_chains - एपीआई कॉल श्रृंखलाओं का विश्लेषण करें
analyze_call_graph - फ़ंक्शन कॉल ग्राफ पैटर्न का विश्लेषण करें
analyze_control_flow - नियंत्रण प्रवाह का विश्लेषण करें
analyze_data_region - डेटा क्षेत्र का विश्लेषण करें
analyze_dataflow - एक फ़ंक्शन के माध्यम से मान प्रसार का पता लगाएं (PCode ग्राफ, आगे/पीछे)
analyze_for_documentation - समग्र RE दस्तावेज़ीकरण विश्लेषण (डीकम्पाइल + वर्गीकरण + चर + पूर्णता)
analyze_function_complete - व्यापक एकल-कॉल फ़ंक्शन विश्लेषण
analyze_function_completeness - दस्तावेज़ीकरण पूर्णता का विश्लेषण करें
analyze_struct_field_usage - स्ट्रक्ट फ़ील्ड उपयोग का विश्लेषण करें
apply_data_classification - डेटा वर्गीकरण लागू करें
batch_analyze_completeness - कई फ़ंक्शनों के लिए बैच में पूर्णता का विश्लेषण करें
batch_apply_documentation - एक कॉल में एक फ़ंक्शन के लिए सभी दस्तावेज़ीकरण लागू करें
batch_decompile - एक बार में कई फ़ंक्शनों को डीकम्पाइल करें
can_rename_at_address - जांचें कि क्या पते का नाम बदला जा सकता है
clear_instruction_flow_override - फ्लो ओवरराइड साफ़ करें
configure_analyzer - एक विश्लेषण प्लगइन कॉन्फ़िगर करें
create_function - पते पर फ़ंक्शन बनाएं
create_memory_block - मेमोरी ब्लॉक बनाएं
delete_function - पते पर फ़ंक्शन हटाएं
detect_array_bounds - सारणी सीमाओं का पता लगाएं
detect_crypto_constants - क्रिप्टो स्थिरांक का पता लगाएं
detect_malware_behaviors - मैलवेयर व्यवहार का पता लगाएं
extract_iocs_with_context - संदर्भ के साथ IOCs निकालें
find_anti_analysis_techniques - एंटी-विश्लेषण तकनीक खोजें
find_code_gaps - निष्पादन योग्य मेमोरी में फ़ंक्शनों के बीच अपरिभाषित बाइट्स के अंतराल खोजें
find_dead_code - डेड कोड खोजें
find_next_undefined_function - अगला अपरिभाषित फ़ंक्शन खोजें
get_assembly_context - असेंबली संदर्भ प्राप्त करें
get_field_access_context - फ़ील्ड एक्सेस संदर्भ प्राप्त करें
get_function_pcode - एक फ़ंक्शन के लिए कच्चा P-कोड डंप करें (मुद्दा #192)
inspect_memory_content - मेमोरी बाइट्स का निरीक्षण करें
list_analyzers - उपलब्ध विश्लेषण प्लगइन सूचीबद्ध करें
read_memory - कच्ची मेमोरी पढ़ें
run_analysis - वर्तमान प्रोग्राम पर ऑटो-विश्लेषण चलाएं
search_instructions - म्नेमोनिक और/या ऑपरेंड सबस्ट्रिंग द्वारा निर्देश खोजें
suggest_field_names - फ़ील्ड नाम सुझाएं

apply_function_documentation - फ़ंक्शन दस्तावेज़ीकरण लागू करें
check_connection - स्वास्थ्य जांच एंडपॉइंट
compare_programs_documentation - प्रोग्रामों में दस्तावेज़ीकरण की तुलना करें
convert_number - आधारों के बीच संख्या परिवर्तित करें
diff_functions - दो फ़ंक्शनों का अंतर देखें
find_undocumented_by_string - स्ट्रिंग का संदर्भ देने वाले अदस्तावेज़ित फ़ंक्शन खोजें
get_bulk_function_hashes - बल्क फ़ंक्शन हैश प्राप्त करें
get_function_documentation - फ़ंक्शन दस्तावेज़ीकरण निर्यात करें
get_function_hash - फ़ंक्शन हैश प्राप्त करें
get_function_signature - फ़ंक्शन फीचर हस्ताक्षर प्राप्त करें
get_metadata - प्रोग्राम मेटाडेटा प्राप्त करें
get_version - प्लगइन संस्करण प्राप्त करें
health - हेडलेस सर्वर के लिए स्वास्थ्य जांच एंडपॉइंट
mcp_health - HTTP सर्वर स्वास्थ्य: पूल आँकड़े, अपटाइम, मेमोरी, सक्रिय अनुरोध गणना
mcp_schema - एंडपॉइंट मेटाडेटा के साथ मशीन-पठनीय एपीआई स्कीमा
tool_goto_address - CodeBrowser सूची और डिकम्पाइलर को एक विशिष्ट पते पर नेविगेट करें
tool_launch_codebrowser - CodeBrowser में एक फ़ाइल खोलें, यदि आवश्यक हो तो एक नया लॉन्च करें
tool_running_tools - सभी चल रहे Ghidra टूल विंडो सूचीबद्ध करें

server_admin_set_permissions - एक रिपॉजिटरी पर उपयोगकर्ता अनुमतियाँ सेट करें
server_admin_terminate_all_checkouts - एक फ़ोल्डर में सभी चेकआउट को पुनरावर्ती रूप से समाप्त करें
server_admin_terminate_checkout - एक एकल फ़ाइल पर सभी चेकआउट समाप्त करें
server_admin_users - सर्वर पर सभी उपयोगकर्ताओं को सूचीबद्ध करें
server_authenticate - प्रोग्रामेटिक प्रमाणीकरण के लिए सर्वर क्रेडेंशियल पंजीकृत करें
server_checkouts - एक फ़ोल्डर में सभी चेक आउट फ़ाइलों को सूचीबद्ध करें, जिसमें सर्वर-साइड चेकआउट शामिल हैं
server_connect - Ghidra सर्वर से कनेक्ट करें
server_disconnect - Ghidra सर्वर से डिस्कनेक्ट करें
server_repositories - कनेक्टेड सर्वर पर रिपॉजिटरी सूचीबद्ध करें
server_repository_create - सर्वर पर एक नई रिपॉजिटरी बनाएं
server_repository_file - सर्वर रिपॉजिटरी से फ़ाइल जानकारी प्राप्त करें
server_repository_files - एक सर्वर रिपॉजिटरी फ़ोल्डर में फ़ाइलें सूचीबद्ध करें
server_version_control_add - संस्करण नियंत्रण में एक फ़ाइल जोड़ें
server_version_control_checkin - एक संस्करण-नियंत्रित फ़ाइल चेक इन करें
server_version_control_checkout - एक संस्करण-नियंत्रित फ़ाइल चेक आउट करें
server_version_control_undo_checkout - एक फ़ाइल चेकआउट पूर्ववत करें
server_version_history - एक फ़ाइल के लिए संस्करण इतिहास प्राप्त करें

debugger_dynamic_to_static - वर्तमान ट्रेस से एक रनटाइम डायनामिक पते को वापस स्थिर Ghidra प्रोग्राम पते में अनुवाद करें
debugger_interrupt - चल रहे लक्ष्य को बाधित करें (इसमें घुसें)
debugger_launch - Ghidra के Trace RMI डीबगर लॉन्चर के माध्यम से एक निष्पादन योग्य लॉन्च करें
debugger_launch_offers - वर्तमान प्रोग्राम के लिए उपलब्ध डीबगर लॉन्च/अटैच विकल्प सूचीबद्ध करें
debugger_list_breakpoints - वर्तमान ट्रेस में सभी ब्रेकपॉइंट सूचीबद्ध करें
debugger_modules - डीबग किए गए प्रोसेस में लोड किए गए मॉड्यूल (DLLs/EXEs) सूचीबद्ध करें
debugger_read_memory - डीबग किए गए प्रोसेस से मेमोरी पढ़ें
debugger_registers - वर्तमान डीबग ट्रेस स्नैपशॉट से सीपीयू रजिस्टर पढ़ें
debugger_remove_breakpoint - एक पते पर एक ब्रेकपॉइंट हटाएं
debugger_resume - डीबग किए गए प्रोसेस का निष्पादन फिर से शुरू करें
debugger_set_breakpoint - ट्रेस में एक पते पर एक सॉफ़्टवेयर निष्पादन ब्रेकपॉइंट सेट करें
debugger_stack_trace - वर्तमान थ्रेड के लिए कॉल स्टैक बैकट्रेस प्राप्त करें
debugger_static_to_dynamic - एक स्थिर Ghidra प्रोग्राम पते को वर्तमान ट्रेस में एक रनटाइम डायनामिक पते में अनुवाद करें
debugger_status - डीबगर स्थिति प्राप्त करें: सक्रिय ट्रेस, थ्रेड, निष्पादन स्थिति, मॉड्यूल गणना
debugger_step_into - अगले निर्देश में एकल-चरण (कॉल का अनुसरण करता है)
debugger_step_out - वर्तमान फ़ंक्शन से बाहर निकलें (रिटर्न तक चलाएं)
debugger_step_over - अगले निर्देश पर कदम (कॉल का अनुसरण नहीं करता)
debugger_traces - सभी खुले डीबग ट्रेस सूचीबद्ध करें

### घटक

- **python/bridge_mcp_ghidra/** — पायथन MCP सर्वर पैकेज (`ghidra-mcp-bridge` व्हील के रूप में भेजा जाता है; `bridge-mcp-ghidra` कंसोल स्क्रिप्ट) जो MCP प्रोटोकॉल को HTTP कॉल में अनुवाद करता है (225 कैटलॉग प्रविष्टियाँ)
- **GhidraMCP.jar** — गिड्रा प्लगइन जो HTTP के माध्यम से विश्लेषण क्षमताओं को उजागर करता है (175 GUI एंडपॉइंट्स)
- **GhidraMCPHeadlessServer** — स्टैंडअलोन हेडलेस सर्वर — 183 एंडपॉइंट्स, कोई GUI आवश्यक नहीं
- **ghidra_scripts/** — सामान्य कार्यों के लिए ऑटोमेशन स्क्रिप्ट्स का संग्रह

## 🔧 विकास

### स्रोत से बनाना```bash
# Recommended: direct Python-first workflow
python -m tools.setup ensure-prereqs --ghidra-path "C:\ghidra_12.1.2_PUBLIC"
python -m tools.setup build
python -m tools.setup deploy --ghidra-path "C:\ghidra_12.1.2_PUBLIC"

# Version bump (updates all maintained version references atomically)
python -m tools.setup bump-version --new X.Y.Z

कमांड	यह क्या करता है
`ensure-prereqs`	Python निर्भरताएँ + Ghidra Maven JARs एक साथ इंस्टॉल करें। नई मशीन पर यहाँ से शुरू करें।
`preflight`	बिना कोई बदलाव किए Python, बिल्ड टूल, Ghidra पथ, और JAR उपलब्धता को मान्य करें। नेटवर्क पहुँच की जाँच करने के लिए `--strict` जोड़ें।
`build`	Maven के माध्यम से प्लगइन JAR और एक्सटेंशन ZIP बनाएँ (या Gradle जब `TOOLS_SETUP_BACKEND=gradle` हो)।
`deploy`	निर्मित एक्सटेंशन को Ghidra प्रोफ़ाइल में कॉपी करें और स्वतः-सक्रियण के लिए `FrontEndTool.xml` को पैच करें।
`start-ghidra`	कॉन्फ़िगर की गई Ghidra स्थापना लॉन्च करें।
`clean`	Maven/Gradle बिल्ड आउटपुट (`target/`, `build/`) हटाएँ।
`clean-all`	बिल्ड आउटपुट के साथ-साथ स्थानीय कैश आर्टिफैक्ट्स (`.m2` Ghidra JARs, आदि) हटाएँ।
`install-ghidra-deps`	केवल Ghidra JARs को `~/.m2` में इंस्टॉल करें। जब बिल्ड वातावरण बदलता है तो उपयोगी।
`install-python-deps`	`uv sync` के माध्यम से Python निर्भरता समूह स्थापित करें।
`run-tests`	Java ऑफ़लाइन परीक्षण सूट चलाएँ (लाइव Ghidra की आवश्यकता नहीं)।
`verify-version`	जाँचें कि संस्करण स्ट्रिंग्स `pom.xml`, `CHANGELOG.md`, और `README.md` में सुसंगत हैं।
`bump-version --new X.Y.Z`	सभी संस्करण संदर्भों को परमाणु रूप से अद्यतन करें। git टैग बनाने के लिए `--tag` पास करें।

फ़्लैग	विवरण
`--ghidra-path PATH`	Ghidra स्थापना निर्देशिका। डिफ़ॉल्ट रूप से `.env` से `GHIDRA_PATH`।
`--dry-run`	कार्यों को निष्पादित किए बिना प्रिंट करें।
`--force`	पहले से मौजूद होने पर भी Ghidra JARs को पुनर्स्थापित करें (`install-ghidra-deps`, `ensure-prereqs`).
`--with-debugger`	डीबगर Python आवश्यकताओं को बलपूर्वक स्थापित करें (केवल Windows).
`--use-debugger-toggle`	यह निर्णय लेने के लिए कि डीबगर डिप्स स्थापित करें या नहीं, `.env` से `INSTALL_DEBUGGER_DEPS` पढ़ें।
`--test TIER`	(`deploy` केवल) लाइव डिप्लॉय रिग्रेशन टियर जैसे `release` या `debugger-live` में ऑप्ट-इन करें।
`--strict`	(`preflight` केवल) Maven Central और PyPI के लिए नेटवर्क पहुँच की भी जाँच करें।

### परियोजना संरचना```
ghidra-mcp/
├── pyproject.toml           # uv project (ghidra-mcp-bridge wheel + dependency groups)
├── python/bridge_mcp_ghidra/ # MCP server package (Python, 225 catalog entries)
├── src/main/java/           # Ghidra plugin + headless server (Java)
│   └── com/xebyte/
│       ├── GhidraMCPPlugin.java         # GUI plugin (196 endpoints)
│       ├── headless/                    # Headless server (183 endpoints)
│       └── core/                        # Shared service layer (12 services)
├── debugger/                # Optional standalone debugger server (port 8099)
├── ghidra_scripts/          # Automation scripts for batch workflows
├── tests/                   # Python unit tests + endpoint catalog
│   ├── unit/               # Catalog consistency, schema, tool function tests
│   └── endpoints.json      # Endpoint specification (225 entries)
├── docs/                    # Documentation
│   ├── prompts/            # AI workflow prompts (V5 documentation workflows)
│   ├── releases/           # Version release notes
│   └── project-management/ # Contributor planning docs (Gradle migration, etc.)
├── tools/setup/             # Build and deployment CLI (python -m tools.setup)
├── fun-doc/                 # Internal RE curation tool — not part of the MCP plugin
│                            #   Priority-queue worker, LLM scoring, web dashboard.
│                            #   See fun-doc/README.md for details.
└── .github/workflows/      # CI/CD pipelines

- `index.js` डोक्यूसॉरस के लिए डिफ़ॉल्ट टेम्पलेट को संशोधित करता है; अधिक विवरण नीचे देखें। यह डोक्यूसॉरस कॉन्फ़िगरेशन फ़ाइल, config.json, से जानकारी का उपयोग करता है, जो डोक्यूसॉरस साइट निर्देशिका (शीर्ष-स्तर) में रखी जाती है। स्क्रिप्ट चलाने के बाद, `website/siteConfig.js` डिफ़ॉल्ट से तदनुसार संशोधित हो जाता है।```text
# Windows
python -m tools.setup install-ghidra-deps --ghidra-path "C:\path\to\ghidra_12.1.2_PUBLIC"

लाइब्रेरी	स्रोत पथ	उद्देश्य
Base.jar	`Features/Base/lib/`	मुख्य Ghidra कार्यक्षमता
Decompiler.jar	`Features/Decompiler/lib/`	डिकंपाइलेशन इंजन
PDB.jar	`Features/PDB/lib/`	Microsoft PDB प्रतीक समर्थन
FunctionID.jar	`Features/FunctionID/lib/`	फ़ंक्शन पहचान
SoftwareModeling.jar	`Framework/SoftwareModeling/lib/`	प्रोग्राम मॉडल API
Project.jar	`Framework/Project/lib/`	प्रोजेक्ट प्रबंधन
Docking.jar	`Framework/Docking/lib/`	UI डॉकिंग फ्रेमवर्क
Generic.jar	`Framework/Generic/lib/`	सामान्य उपयोगिताएँ
Utility.jar	`Framework/Utility/lib/`	मुख्य उपयोगिताएँ
Gui.jar	`Framework/Gui/lib/`	GUI घटक
FileSystem.jar	`Framework/FileSystem/lib/`	फ़ाइल सिस्टम समर्थन
Graph.jar	`Framework/Graph/lib/`	ग्राफ/कॉल ग्राफ विश्लेषण
DB.jar	`Framework/DB/lib/`	डेटाबेस संचालन
Emulation.jar	`Framework/Emulation/lib/`	P-कोड अनुकरण

### हेडलेस API कार्यप्रवाह```bash
# 1. Load a binary
curl -X POST -d "file=/data/program.exe" http://localhost:8089/load_program

# 2. Run auto-analysis (identifies functions, strings, data types)
curl -X POST http://localhost:8089/run_analysis

# 3. List discovered functions
curl "http://localhost:8089/list_functions?limit=20"

# 4. Decompile a function
curl "http://localhost:8089/decompile_function?address=0x401000"

# 5. Get metadata
curl http://localhost:8089/get_metadata

एंडपॉइंट	विधि	विवरण
`/load_program`	POST	विश्लेषण के लिए बाइनरी फ़ाइल लोड करें
`/run_analysis`	POST	Ghidra स्वचालित-विश्लेषण चलाएँ
`/list_functions`	GET	सभी खोजे गए फ़ंक्शन सूचीबद्ध करें
`/list_exports`	GET	निर्यातित प्रतीक सूचीबद्ध करें
`/list_imports`	GET	आयातित प्रतीक सूचीबद्ध करें
`/decompile_function`	GET	फ़ंक्शन को C कोड में डीकंपाइल करें
`/create_function`	POST	पते पर फ़ंक्शन बनाएँ
`/get_metadata`	GET	प्रोग्राम मेटाडेटा प्राप्त करें
`/create_project`	POST	Ghidra प्रोजेक्ट बनाएँ
`/list_analyzers`	GET	उपलब्ध विश्लेषक सूचीबद्ध करें
`/server/status`	GET	Ghidra सर्वर कनेक्शन जाँचें

मीट्रिक	मान
संस्करण	5.17.0
MCP उपकरण	249 पूरी तरह से लागू
GUI एंडपॉइंट्स	196 (GhidraMCPPlugin)
हेडलेस एंडपॉइंट्स	195 (GhidraMCPHeadlessServer)
संकलन	✅ 100% सफलता
बैच दक्षता	93% API कॉल में कमी
एआई वर्कफ़्लो	7 सिद्ध दस्तावेज़ीकरण वर्कफ़्लो
Ghidra स्क्रिप्ट्स	स्वचालन स्क्रिप्ट्स शामिल
दस्तावेज़ीकरण	AI प्रॉम्प्ट्स के साथ व्यापक

ghidra-mcp

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

Ghidra MCP Server

क्यों घिड्रा एमसीपी?

परंपरा प्रवर्तन

🌟 विशेषताएँ

कोर MCP एकीकरण

बाइनरी विश्लेषण क्षमताएँ

गतिशील विश्लेषण (v5.4.0)

AI-संचालित रिवर्स इंजीनियरिंग वर्कफ़्लो

विकास और ऑटोमेशन

🚀 त्वरित आरंभ

पूर्वापेक्षाएँ

स्थापना

Skip automatic prerequisite setup

Manual Maven build (requires Ghidra deps already installed in local .m2)

स्थापना (लिनक्स — उबंटू/डेबियन)

स्थापना (macOS — Homebrew)

स्थापना (Arch Linux — AUR)

ब्रिज उन्नत फ़्लैग्स

कठोर प्रोग्राम रूटिंग (मल्टी-प्रोग्राम सुरक्षा)

Ghidra में

सत्यापित करें कि यह काम कर रहा है```bash

Quick health check

Expected: "Connected: GhidraMCP plugin running with program ''"

Get version info

Ghidra सर्वर प्रमाणीकरण

v5.4.0 → v5.4.1 से माइग्रेशन

❓ समस्या निवारण

"GhidraMCP" मेनू Tools में दिखाई नहीं दे रहा है

सर्वर प्रतिक्रिया नहीं दे रहा / कनेक्शन अस्वीकृत

Linux/macOS

Windows

pip install error: externally-managed-environment के साथ विफल होता है

python -m debugger pybag या comtypes के लिए ModuleNotFoundError के साथ विफल होता है

📊 उत्पादन प्रदर्शन

🛠️ एपीआई संदर्भ

प्रोग्राम और सत्र प्रबंधन

परियोजना संगठन

हेडलेस परियोजना और प्रोग्राम जीवनचक्र

सूचीकरण और गणना

संदर्भ और लुकअप

खोज

विघटन और डिसअसेम्बली

फ़ंक्शन टैग, चर और विशेषताएँ

क्रॉस-रेफरेंस

डेटा प्रकार और संरचनाएँ

नामकरण और लेबल

टिप्पणियाँ और बुकमार्क

विश्लेषण

क्रॉस-बाइनरी दस्तावेज़ीकरण और संग्रह

उपयोगिता और दस्तावेज़ीकरण स्थानांतरण

एम्यूलेशन

स्क्रिप्टिंग

Ghidra सर्वर और संस्करण नियंत्रण

डीबगर (Ghidra TraceRmi — केवल GUI)

सिस्टम

🏗️ आर्किटेक्चर```

Command Reference

Standard first-time setup and deploy

Preflight check before deploying

Version bump and tag

Run offline Java tests

Show full help

लाइब्रेरी निर्भरताएँ

समस्या निवारण: वर्ज़न बेमेल

विकास सुविधाएँ

📚 दस्तावेज़ीकरण

मुख्य दस्तावेज़ीकरण

AI कार्यप्रवाह प्रॉम्प्ट

रिलीज़ इतिहास

🐳 हेडलेस सर्वर (Docker)

Docker के साथ त्वरित प्रारंभ```bash

Build and run

Test connection

Connection OK - GhidraMCP Headless Server v5.17.0

मुख्य हेडलेस एंडपॉइंट्स

कॉन्फ़िगरेशन

🤝 योगदान

त्वरित आरंभ

`pip install` `error: externally-managed-environment` के साथ विफल होता है

`python -m debugger` `pybag` या `comtypes` के लिए `ModuleNotFoundError` के साथ विफल होता है