The problem
How it works
GhidraMCP is an Apache-2.0 MCP server shipped as a Ghidra extension plus a Python client. After installing the extension and enabling the plugin, an MCP client launches the ghidra-mcp command, which talks to Ghidra's local HTTP server. The agent can then decompile functions, list methods, classes, imports and exports, and rename functions and data. A headless mode through PyGhidra is also documented.
Results and limitations
The README documents setup and tools only and reports no case results. Its client configuration examples cover VS Code and Claude Code.
Before you try it
Analyse only software you own or are permitted to reverse engineer; many licences forbid it. Handle unknown binaries in a virtual machine even though static analysis in Ghidra does not need to run them. Names an agent proposes are hypotheses, so back up the Ghidra project and review renames before applying them. The current README targets Ghidra 12.1.4 and Python 3.10 or later. Results depend on your setup and were not independently reproduced by Top 200 Repos.
Tools and repositories
- Tools
- Ghidra 12.1.4 · GhidraMCP extension and Python client · An MCP client such as Claude Code
- Prerequisites
- Ghidra with the GhidraMCP extension enabled, uv or Python 3.10 or later, and permission to analyse the target.
Try it yourself: Map a binary before renaming anything
Fill the fields to adapt the prompt. Empty fields stay as visible [placeholders].
Using the GhidraMCP tools on [Program open in Ghidra], which is already open in Ghidra, list its imports and exports, then find the functions most likely responsible for [Behaviour to locate]. For each candidate, decompile it and give a short explanation, the evidence that supports your reading (strings, calls or constants) and a proposed new name. Do not rename anything yet: show a table of current name, proposed name and confidence, and apply only the rows I approve. Never execute the binary.Confirm you have the right to analyse the program before starting.
Related videos
About NationalSecurityAgency/ghidra
GitHub’s top: Copy any app, create gorgeous videos, 3d print anything & more (opens in a new tab)
The description links the GitHub repository.
Watch on YouTube (opens in a new tab)Independent creators. Listing a video implies no endorsement, sponsorship or partnership.
Sources
- LaurieWired/GhidraMCP README (opens in a new tab)
Project documentation · github.com · Undated · Source checked 11 Nov 2026, 22:04 UTC
What this source supports
- MCP server that exposes core Ghidra functions to LLM clients
- Decompiles binaries, renames methods and data, and lists methods, classes, imports and exports
- Installs as a Ghidra extension, with MCP clients launching the ghidra-mcp command
- Configuration examples for VS Code and Claude Code
- Optional headless mode with PyGhidra
- Apache-2.0 licence
