PyGhidra-MCP - Ghidra मॉडल संदर्भ प्रोटोकॉल सर्वर

अवलोकन

pyghidra-mcp एक कमांड-लाइन मॉडल संदर्भ प्रोटोकॉल (MCP) सर्वर है जो Ghidra की पूर्ण विश्लेषणात्मक क्षमता, जो एक मजबूत सॉफ्टवेयर रिवर्स इंजीनियरिंग (SRE) सूट है, को बुद्धिमान एजेंटों और LLM-आधारित उपकरणों की दुनिया में लाता है। यह pyghidra और jpype का उपयोग करके Ghidra के ProgramAPI और FlatProgramAPI को Python से जोड़ता है, और फिर उस कार्यक्षमता को मॉडल संदर्भ प्रोटोकॉल के माध्यम से प्रस्तुत करता है।

MCP एक एकीकृत इंटरफ़ेस है जो भाषा मॉडलों, विकास उपकरणों (जैसे VS Code), और स्वायत्त एजेंटों को संरचित संदर्भ तक पहुँचने, उपकरणों को लागू करने, और बुद्धिमानी से सहयोग करने की अनुमति देता है। MCP को शक्तिशाली विश्लेषण उपकरणों और LLM पारिस्थितिकी तंत्र के बीच के पुल के रूप में सोचें।

pyghidra-mcp के साथ, Ghidra एक बुद्धिमान बैकएंड बन जाता है—जो संदर्भ-समृद्ध प्रश्नों का उत्तर देने, गहन रिवर्स इंजीनियरिंग कार्यों को स्वचालित करने, और AI-सहायक वर्कफ़्लो में एकीकृत होने के लिए तैयार है।

pyghidra-mcp अब दो ऑपरेटिंग मोड का समर्थन करता है:

headless मोड CLI-संचालित विश्लेषण और स्वचालन के लिए
--gui मोड, जो pyghidra-mcp के माध्यम से Ghidra लॉन्च करता है और चल रहे GUI के साथ लाइव प्रोग्राम स्थिति साझा करता है

[!NOTE] यह बीटा परियोजना सक्रिय विकास के अंतर्गत है। हम आपकी प्रतिक्रिया, बग रिपोर्ट, सुविधा अनुरोध और कोड का स्वागत करते हैं।

एक और Ghidra MCP?

हाँ, मूल ghidra-mcp शानदार है। लेकिन pyghidra-mcp एक अलग दृष्टिकोण लेता है:

🐍 हेडलेस-प्रथम, GUI-सक्षम – स्ट्रीमलाइन स्वचालन के लिए पूरी तरह से CLI के माध्यम से चलाएँ, या जब आप लाइव GUI नेविगेशन और संपादन चाहते हैं तो --gui के साथ Ghidra लॉन्च करें।
🔁 स्वचालन के लिए डिज़ाइन – LLMs, CI पाइपलाइनों और ऐसे उपकरणों के साथ एकीकरण के लिए आदर्श जिन्हें दोहराए जाने योग्य व्यवहार की आवश्यकता है।
✅ CI/CD अनुकूल – क्लाइंट और सर्वर दोनों सत्रों के लिए मजबूत यूनिट और इंटीग्रेशन परीक्षणों के साथ निर्मित।
🚀 त्वरित स्टार्टअप – एसिंक्रोनस स्टार्टअप सर्वर को अनुरोधों को संभालना शुरू करने देता है जबकि बाइनरी अभी भी पृष्ठभूमि में विश्लेषित की जा रही हैं। न्यूनतम सेटअप के साथ तेज़ कमांड-लाइन लॉन्चिंग का समर्थन करता है।
📦 प्रोजेक्ट-व्यापी विश्लेषण – Ghidra प्रोजेक्ट में सभी बाइनरी के समवर्ती रिवर्स इंजीनियरिंग को सक्षम करता है
🤖 एजेंट-तैयार – बुद्धिमान एजेंट-संचालित वर्कफ़्लो और बड़े पैमाने पर रिवर्स इंजीनियरिंग स्वचालन के लिए निर्मित।
🔍 अर्थपूर्ण कोड खोज – डीकंपोज़्ड फ़ंक्शन, टिप्पणियों और प्रतीकों में तेज़, फजी लुकअप को सक्षम करने के लिए वेक्टर एम्बेडिंग (ChromaDB के माध्यम से) का उपयोग करता है - स्यूडो-C अन्वेषण और एजेंट-संचालित ट्रायेज के लिए एकदम सही।

यह परियोजना स्थानीय विकास, हेडलेस वातावरण और परीक्षण योग्य वर्कफ़्लो के लिए अनुकूलित एक Python-प्रथम अनुभव प्रदान करता है।

सेटअप आरेख

टुकड़े कैसे जुड़ते हैं```mermaid

flowchart LR subgraph Clients["Clients"] Agent["MCP host / agent"] Cli["pyghidra-mcp-cli"] User["Ghidra user"] end

subgraph Process["pyghidra-mcp process"]
    Transport["stdio or streamable-http"]
    Tools["MCP tools"]
    Context["PyGhidra context"]
end

Project["Ghidra project<br/>.gpr / .rep"]
Artifacts["MCP artifacts<br/>ChromaDB + GZF cache"]
Gui["Ghidra GUI / CodeBrowser<br/>only with --gui"]

Agent -->|"stdio or HTTP"| Transport
Cli -->|"HTTP only"| Transport
Transport --> Tools
Tools --> Context
Context --> Project
Context --> Artifacts
Context -.-> Gui
User -.-> Gui
Gui -.-> Project

### एक मोड चुनना```mermaid
flowchart TD
    Start["What do you need?"]
    Start --> Headless["Agent or automation only"]
    Start --> GuiNeed["Live Ghidra GUI control"]
    Start --> Terminal["Interactive terminal client"]

    Headless --> Stdio["pyghidra-mcp -t stdio<br/>or -t streamable-http"]
    GuiNeed --> GuiMode["pyghidra-mcp --gui<br/>--transport streamable-http<br/>--project-path project.gpr"]
    Terminal --> HttpServer["Start pyghidra-mcp<br/>--transport streamable-http"]
    HttpServer --> CliMode["Run pyghidra-mcp-cli commands"]

हेडलेस MCP: स्थानीय MCP होस्ट के लिए stdio का उपयोग करें, या जब कई क्लाइंट को एक ही लंबे समय तक चलने वाले Ghidra प्रोजेक्ट की आवश्यकता हो तो streamable-http का उपयोग करें।
GUI मोड: pyghidra-mcp Ghidra को लॉन्च करता है, प्रोजेक्ट खोलता है, और अतिरिक्त टूल्स को उजागर करता है जो उसी JVM में CodeBrowser को संचालित करते हैं।
CLI क्लाइंट: pyghidra-mcp-cli एक HTTP क्लाइंट है। पहले एक streamable-http सर्वर प्रारंभ करें, फिर उस चल रहे सर्वर के विरुद्ध टर्मिनल कमांड जारी करें।

विस्तृत आर्किटेक्चर और टूल सतह

```mermaid flowchart TD subgraph Clients Agent["LLM / MCP host"] Cli["pyghidra-mcp-cli"] Automation["scripts and CI"] end

subgraph Transports
    Stdio["stdio"]
    Http["streamable-http"]
    Sse["sse legacy"]
end

subgraph Server["pyghidra-mcp server"]
    FastMcp["FastMCP tool server"]
    Context["PyGhidra context"]
    Indexing["background analysis and Chroma indexing"]

    subgraph Tools["MCP tools"]
        Analysis["decompile, xrefs, bytes, callgraph"]
        Search["symbols, strings, code"]
        ProjectOps["import, delete, metadata, list binaries"]
        Edits["rename function, rename variable, set type, set prototype, set comment"]
        GuiOnly["GUI only: open program, goto, list open programs, set current program"]
    end
end

subgraph GhidraRuntime["Ghidra runtime"]
    PyGhidra["pyghidra"]
    Jpype["JPype shared JVM"]
    Project["Ghidra project"]
    Programs["program databases"]
    CodeBrowser["Ghidra GUI / CodeBrowser"]
end

Agent --> Stdio
Agent --> Http
Automation --> Stdio
Automation --> Http
Automation --> Sse
Cli --> Http

Stdio --> FastMcp
Http --> FastMcp
Sse --> FastMcp

FastMcp --> Context
Context --> PyGhidra
PyGhidra --> Jpype
Jpype --> Project
Project --> Programs
Context --> Indexing
Indexing --> Search

FastMcp --> Tools
Tools --> Context
GuiOnly -.-> CodeBrowser
Context -.-> CodeBrowser

</details>

## विषय सूची

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

pyghidra-mcp

PyGhidra-MCP - Ghidra मॉडल संदर्भ प्रोटोकॉल सर्वर

अवलोकन

एक और Ghidra MCP?

सेटअप आरेख

टुकड़े कैसे जुड़ते हैं```mermaid