GhidraMCP README

The project's README from github.com/LaurieWired/GhidraMCP. As one markdown file: README.md.

License GitHub release (latest by date) GitHub stars GitHub forks GitHub contributors Follow @lauriewired

ghidra_MCP_logo

ghidraMCP

ghidraMCP is an Model Context Protocol server for allowing LLMs to autonomously reverse engineer applications. It exposes numerous tools from core Ghidra functionality to MCP clients.

https://github.com/user-attachments/assets/36080514-f227-44bd-af84-78e29ee1d7f9

Features

MCP Server + Ghidra Plugin

Installation

Prerequisites

Ghidra

First, download the latest release from this repository. This contains the Ghidra plugin and Python MCP client. Then, you can directly import the plugin into Ghidra.

  1. Run Ghidra
  2. Select File -> Install Extensions
  3. Click the + button
  4. Select the ghidra_12.1.4_PUBLIC_<date>_GhidraMCP.zip from the downloaded release
  5. Restart Ghidra
  6. Make sure the GhidraMCPPlugin is enabled in File -> Configure -> Developer
  7. Optional: Configure the port in Ghidra with Edit -> Tool Options -> GhidraMCP HTTP Server

Video Installation Guide:

https://github.com/user-attachments/assets/75f0c176-6da1-48dc-ad96-c182eb4648c3

MCP Clients

Theoretically, any MCP client should work with ghidraMCP. Most clients accept a JSON config like the following:

{
  "mcpServers": {
    "ghidra": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/LaurieWired/GhidraMCP",
        "ghidra-mcp",
        "--ghidra-server",
        "http://127.0.0.1:8080/"
      ]
    }
  }
}

The server IP and port are configurable and should be set to point to the target Ghidra instance. If not set, both will default to localhost:8080.

For clients that connect to a URL instead of launching a command, first run the MCP server yourself:

uvx --from git+https://github.com/LaurieWired/GhidraMCP ghidra-mcp --transport streamable-http --mcp-host 127.0.0.1 --mcp-port 8081 --ghidra-server http://127.0.0.1:8080/

Then add http://127.0.0.1:8081/mcp as a remote server in your client.

Example 1: VS Code

Run MCP: Add Server from the Command Palette, or add the following to .vscode/mcp.json in your workspace:

{
  "servers": {
    "ghidra": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/LaurieWired/GhidraMCP",
        "ghidra-mcp",
        "--ghidra-server",
        "http://127.0.0.1:8080/"
      ]
    }
  }
}

Example 2: Claude Code

Run the following command:

claude mcp add ghidra -- uvx --from git+https://github.com/LaurieWired/GhidraMCP ghidra-mcp --ghidra-server http://127.0.0.1:8080/

Headless (no Ghidra GUI)

ghidra-mcp can also import and analyze a binary itself using PyGhidra, with no Ghidra GUI running. This needs Python 3.10–3.13, the GhidraMCP extension installed in Ghidra (or --extension-jar /path/to/GhidraMCP.jar), and GHIDRA_INSTALL_DIR set to your Ghidra 12.1.4 directory:

uvx --python 3.13 --from "ghidra-mcp[headless] @ git+https://github.com/LaurieWired/GhidraMCP" ghidra-mcp --headless --binary /path/to/target

Use the same command and arguments in any of the client configs above. Add --project DIR to keep the Ghidra project (and save changes) between runs. On macOS, build Ghidra's decompiler once with support/gradle/gradlew buildNatives from the Ghidra directory.

Building from Source

  1. Set GHIDRA_INSTALL_DIR to your Ghidra 12.1.4 directory
  2. Build the extension with Gradle (Java 21) by running:

cd extension && $GHIDRA_INSTALL_DIR/support/gradle/gradlew buildExtension

The generated zip file in extension/dist/ includes the built Ghidra plugin and its resources. These files are required for Ghidra to recognize the new extension.

The Python MCP server can be run from a checkout with uv run ghidra-mcp, and tested with uv run pytest.

GhidraMCP (LaurieWired/GhidraMCP)

Searching Database…

11.4K ·GitHub
GhidraMCP
What is this?GhidraMCP is a Model Context Protocol server that lets LLMs autonomously reverse engineer applications by exposing Ghidra's core functionality (decompiling, renaming, listing imports/exports) to any MCP client.
Is this a Ghidra plugin or a standalone server?It's both: a Ghidra extension (Java) that runs inside Ghidra and exposes an HTTP interface, plus a separate Python MCP server (ghidra-mcp) that MCP clients talk to.
How do I get it connected to an MCP client?Download the release zip, install the plugin in Ghidra via File -> Install Extensions, restart Ghidra and enable it under File -> Configure -> Developer, then point your MCP client (e.g. VS Code or Claude Code) at the running server, which defaults to localhost:8080.
What do I need installed before trying this?You need Ghidra 12.1.4 plus either uv or Python 3.10+ (installed via pip install git+ and then run as ghidra-mcp).
Do I need the Ghidra GUI running to use it?No - a headless mode using PyGhidra can import and analyze a binary without the GUI, but it needs Python 3.10-3.13, the GhidraMCP extension jar, and GHIDRAINSTALLDIR set; on macOS you must also build Ghidra's decompiler natives once.
Which MCP clients does it work with?Theoretically any MCP client; the README shows configs for VS Code (via .vscode/mcp.json) and Claude Code.
What can the exposed tools actually do?They can decompile and analyze binaries, automatically rename methods and data, and list methods, classes, imports, and exports from inside Ghidra.
Can I keep my Ghidra project between headless runs?Yes, add --project DIR to the headless command to preserve the project and any saved changes between runs.
What are similar projects?Seep-Reverse-Lab, reverify, rea, ida-pro-mcp, rea, ghidra, ghidra-mcp, awesome-reverse-engineering
Which topics is it in?decompiler, malware-analysis, binary-analysis, security-research, hacking-tool, model-context-protocol, reverse-engineering, security-tools, java, mcp-server, agent, claude-code
Creator
LaurieWired
Size
0.4 MB
Stars
11.4K
Updated
CommitOct 10Release2.0Oct 10
Age
1y
Commits · 90 Days