bethington / ghidra-mcp
git clone https://github.com/bethington/ghidra-mcp.git
v6.0.0 · 2mo ago
🔥 on GitHub Trending today
MCP server that exposes Ghidra's reverse engineering capabilities as 200+ tools for AI assistants, via a GUI plugin and headless server.
Why you might care
Gives AI clients broad, write-capable access to Ghidra (decompilation, renaming, batch operations, lazy tool loading) rather than a few read-only tools. Supports Docker deployment and Ghidra Server integration; releases install as a Ghidra extension plus a Python bridge, but the extension only loads in the specific Ghidra version it was built for.
+9
stars, 24h · #1,504
+~63
stars, 7 days · #1,932
+1.9k
stars, 30 days · #278
5.8k
★ total · +1% this week
348
forks · 33 open issues
Star history (as recorded here)
LanguageJava
LicenseApache-2.0
Created2025-08-30 (1y ago)
Last push5d ago
Watchers23
OwnerUser
Seen on GitHub Trending
- 2026-10-21 — #11 monthly in java · +1,927 ★
- 2026-10-20 — #11 monthly in java · +1,919 ★
GitHub topics
aibinary-analysisghidraghidra-extensionjavamcpmcp-servermodel-context-protocolpythonreverse-engineeringstatic-analysis
Links
README excerpt
# Ghidra MCP Server > If you find this useful, please ⭐ star the repo — it helps others discover it! > > If Ghidra MCP saves you time, consider sponsoring the project. One-time and recurring support both help fund compatibility updates, production hardening, docs, and new tooling. A production-ready Model Context Protocol (MCP) server that bridges Ghidra's powerful reverse engineering capabilities with modern AI tools and automation frameworks. **209 MCP tools**, battle-tested AI workflows, and the most comprehensive Ghidra-MCP integration available — now including P-code emulation, live debugger integration, and PCode-graph data flow analysis. ## Quickstart: install a release (no clone, no build) Every release ships the two pieces you need: the Ghidra extension (`GhidraMCP- .zip`) and the MCP bridge (`ghidra_mcp_bridge- -py3-none-any.whl`). 1. **Install the prerequisites:** Ghidra 12.1.4, Java 21 and uv. The extension only loads in the exact Ghidra version it was built for. 2. **Install the extension:** in Ghidra's project window, **File > Install Extensions**, click **+**, pick the `GhidraMCP- .zip` you downloaded, and restart Ghidra. 3. **Enable the plugin:** in the project window, **File > Configure > Utility > Configure**, tick **GhidraMCPPlugin**. Check it answers: [code] 4. **Install the bridge** (copy the wheel's link from the same release page): [code] 5. **Point your MCP client at it**, using the absolute path (`which bridge-mcp-ghidra`, or `where.exe bridge-mcp-ghidra` on Windows): [code] On Windows: `"command": "C:\\Users\\ \\.local\\bin\\bridge-mcp-ghidra.exe"`. A client launched from a GUI or a service does not see your shell's PATH, so a bare `bridge-mcp-ghidra` fails with `spawn ENOENT`. Open a program in Ghidra and ask your AI tool to list its functions. Screenshots of steps 2-3: docs/INSTALL_GUI.md. Building from source, Docker, the HTTP transports and every bridge flag are further down. **Which version should I run?** Tagged releases (7.0.0, 7.1.0, ...) are stable. Release candidates and `main` are beta: feature-complete and live-tested, but shapes can still change before final. `dev` is experimental: tools are merged, renamed and refactored there freely, so build nothing on its API. ## Why Ghidra MCP? Most Ghidra MCP implementations give you a handful of read-only tools and call it a day. This project is different — it was built by a reverse engineer who uses it daily on real binaries, not as a demo. - **209 MCP tools** — 3x more than any competing implementation. Not just read operations — full write access for renaming, typing, commenting, structure creation, script execution, P-code emulation, and live debugging. - **Battle-tested AI workflows** — Proven documentation workflows (V5) refined across hundreds of functions. Includes step-by-step prompts, Hungarian notation reference, batch processing guides, and orphaned code discovery. - **Production-grade reliability** — Atomic transactions, batch operations (9
Blurb generated by claude-haiku-5-5 today. Star deltas marked ~ are extrapolated from partial history.