LibreAI / AI Agents / ghidra-mcp
// agents · bethington/ghidra-mcp

ghidra-mcp

Ghidra MCP server with 200+ tools that let AI assistants drive real reverse-engineering work

★ 4.9k stars⑂ 229 forksApache-2.0updated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

ghidra-mcp is an open-source ai agents project by bethington (bethington/ghidra-mcp on GitHub). It has 4,877 GitHub stars and 229 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 8 October 2026.

GitHub stars
4,877
Forks
229
License
Apache-2.0
Last updated on GitHub
8 October 2026
Category
AI Agents
Listing
Full install guide
// how it works

How it works

  1. Clarify your target

    Decide whether you will analyze binaries in the Ghidra GUI or run the headless server for automated/CI analysis.

  2. Install prerequisites

    Install Ghidra, Java 21, and Python 3.10+ (Maven 3.9+ or the bundled Gradle wrapper for builds).

  3. Build and deploy the extension

    Clone the repo and use the setup tool to run preflight, install prerequisites, build, and deploy into your Ghidra installation.

  4. Connect your MCP client and analyze

    Start Ghidra (or the headless server), connect your AI client to the bridge, and run a first function-documentation workflow.

// features

Why people love it

209 MCP tools

A comprehensive API surface covering decompilation, call graphs, cross-references, memory inspection, and more.

Full write access

Rename, retype, comment, and create structures — with convention enforcement (auto-fix, warn, or reject) keeping names and types consistent.

Dynamic analysis

P-code emulation to run functions in isolation, plus live debugger integration with breakpoints, stepping, registers, and memory reads.

Cross-binary documentation transfer

SHA-256 function-hash matching propagates documentation across binary versions automatically.

Batch operations

Bulk renaming, commenting, and typing with far fewer API calls, plus atomic transactions and configurable timeouts.

GUI, headless, and server modes

Run inside the Ghidra GUI, headless for Docker/CI pipelines, and against shared Ghidra Servers with version-control workflows.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Clone the project and enter its directory.

    git clone https://github.com/bethington/ghidra-mcp.git
    cd ghidra-mcp
  2. Preflight and build

    Run the setup tool's preflight against your Ghidra install, install prerequisites, and build (adjust the Ghidra path to your machine).

    python -m tools.setup preflight --ghidra-path ~/ghidra_12.1.4_PUBLIC
    python -m tools.setup ensure-prereqs --ghidra-path ~/ghidra_12.1.4_PUBLIC
    python -m tools.setup build
  3. Deploy to Ghidra

    Deploy the extension; it installs into Ghidra, starts it, and runs MCP health checks.

    python -m tools.setup deploy --ghidra-path ~/ghidra_12.1.4_PUBLIC
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains ghidra-mcp?

Developer bethington, who describes it as built by a reverse engineer for daily use on real binaries; it is community-maintained and distinct from the NSA's Ghidra project itself.

Is ghidra-mcp free?

Yes — the server is Apache-2.0 licensed, and Ghidra itself is free and open source. You supply your own AI client/model access.

Does it need a paid API key?

The server itself needs no key, but the AI client you connect (for example a commercial coding assistant) may require its own subscription or API key.

How does it compare to other Ghidra MCP servers?

The README positions it as the most comprehensive option — 209 tools with write access, emulation, debugging, and Ghidra Server support, versus the handful of mostly read-only tools in simpler bridges.

How do I get started?

Install Ghidra 12.1.4, Java 21, and Python 3.10+, clone the repo, and run the `python -m tools.setup` preflight, build, and deploy sequence from the README.

// keep exploring

Similar tools

AI Agents

github-mcp-server

GitHub's official MCP server — let AI tools work with repos, issues and pull requests

★ 33.4k starsMIT
View guide →
AI Agents

x64dbg-mcp-server

Native MCP plugin for x64dbg — let an AI drive the debugger: breakpoints, stepping, memory, registers

★ 2.4k starsMIT
View guide →
AI Agents

excel-mcp-server

Excel MCP Server: let AI agents read, write, format, and chart real .xlsx workbooks — no Excel required

★ 4.2k starsMIT
View guide →
AI Agents

arxiv-mcp-server

A local MCP server for serious arXiv work — LaTeX section reads, BibTeX and topic watches.

★ 3.2k starsApache-2.0
View guide →
AI Agents

ida-pro-mcp

AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.

★ 12.5k starsMIT
View guide →
AI Agents

google_workspace_mcp

Control Gmail, Calendar, Docs, Sheets, Drive and more from AI — a full Google Workspace MCP server.

★ 3.3k starsMIT
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if ghidra-mcp is not the right fit.

Get ghidra-mcp

Free and open — grab the source, star the repo, and start creating.