GhidraMCP

At a glance

GhidraMCP pairs a Ghidra extension, which serves the open program over a small local HTTP server, with an MCP server that turns those endpoints into tools. The assistant can list functions, classes, imports and strings, decompile or disassemble a function, follow cross-references and write back better names, types and comments.

Unlike IDA Pro MCP it needs no paid licence: Ghidra is free. There is also a headless mode that imports and analyses a binary on its own through PyGhidra, with no Ghidra window open.

Made by

LaurieWired

GitHub stars

11.6K

Downloads

62 a week

Last commit

10 Oct 2026

Tools

30

Runs on

Your computer

Our check: We ran this exact config on 27 Oct 2026: it started and answered with 30 tools. The shared database ran "uvx ghidramcp". That PyPI name only holds a 0.0.dev0 placeholder, so we publish the install the project documents: straight from its GitHub source.

What's in the pod: its tools

We found 30 tools when we started it on 27 Oct 2026. 19 only read. The rest can change things, so keep your app's "ask before each tool call" setting on for them.

How we tested it: Started from the GitHub source without Ghidra running. It lists its tools on its own; calling them needs Ghidra open with the GhidraMCP extension.

Grouped and described by us. The README on GitHub lists the inputs each tool takes.

Set it up

1. Download the latest release zip from the GhidraMCP repository.
2. In Ghidra choose File → Install Extensions, click +, pick the zip and restart Ghidra.
3. Make sure GhidraMCPPlugin is ticked under File → Configure → Developer, then open a program in the CodeBrowser.

Pick your app for the exact snippet and where it goes.

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

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

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

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

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

Change the --ghidra-server address if you moved the plugin to another port under Edit → Tool Options.

New to this? See the setup guides for Claude Code, Cursor, Claude Desktop and ChatGPT.

Settings

Names are exactly as the project spells them. Required ones are marked.

What it can touch

Safer setup: It never runs the binary, and all its changes are annotations. Keep a copy of the Ghidra project if you want to compare the model's renames with your own.

Before you start

• Ghidra 12.1.4 with the GhidraMCP extension installed
• uv (for uvx), or Python 3.10 or newer

If it does not work

Every tool returns a connection error

Ghidra must be running with a program open in the CodeBrowser, and GhidraMCPPlugin must be enabled under File → Configure → Developer.

The extension will not install

Each release is built for one Ghidra version. Use the zip that matches your Ghidra (12.1.4 for the current release) or build it from source with Gradle and Java 21.

Port 8080 is already taken

Change the port in Edit → Tool Options → GhidraMCP HTTP Server and pass the same address to --ghidra-server.

Headless mode fails on macOS

Build Ghidra's decompiler once with support/gradle/gradlew buildNatives from the Ghidra folder.

Peas in a pod: similar servers

How GhidraMCP lines up against other developer tools servers on the shelf.

Questions

Something wrong on this page? Tell us.