GhidraMCP for Ghidra 12.0.1

![Ghidra Version](https://ghidra-sre.org) ![JDK Version](https://openjdk.org) ![License](https://www.apache.org/licenses/LICENSE-2.0)

An updated fork of LaurieWired's GhidraMCP with full support for Ghidra 12.0.1 and JDK 21.

What's Changed from Original

| Feature | Original | This Fork | |---------|----------|-----------| | Ghidra Version | 11.3.2 | 12.0.1 | | JDK Version | 5 (deprecated) | 21 | | Maven Compiler | Default | 3.11.0 with release 21 | | JUnit | 3.8.1 | 5.10.0 |

Fixes for Known Issues

This fork addresses the following issues from the original repository:

✅ Issue #99: "Source option 5 is no longer supported" - Fixed with JDK 21 configuration
✅ Issue #96: Extension installation errors - Rebuilt for Ghidra 12
✅ Issue #54: Installation issues - Updated JAR dependencies

Features

MCP Server - Exposes Ghidra functionality via Model Context Protocol
LLM Integration - Connect Claude, GPT, or other LLMs to Ghidra
Decompilation - Automated binary analysis and decompilation
Symbol Management - Rename methods, variables, and data
Analysis Tools - List methods, classes, imports, exports

Quick Start

Prerequisites

Installation

Download the latest release: GhidraMCP-2.0-ghidra12.zip

Install in Ghidra:

   File → Install Extensions → + → Select GhidraMCP-2.0-ghidra12.zip

Restart Ghidra

Enable the Plugin:

   File → Configure → Developer → Enable GhidraMCPPlugin

Install Python Dependencies:

   pip install mcp modelcontextprotocol

Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ghidra": {
      "command": "python",
      "args": [
        "/path/to/bridge_mcp_ghidra.py",
        "--ghidra-server",
        "http://127.0.0.1:8080/"
      ]
    }
  }
}

Configure Cline (VS Code)

Start the MCP server:

   python bridge_mcp_ghidra.py --transport sse --mcp-host 127.0.0.1 --mcp-port 8081

In Cline, add Remote Server:

Name: GhidraMCP
URL: http://127.0.0.1:8081/sse

Building from Source

# Clone the repository
git clone https://github.com/YOUR_USERNAME/GhidraMCP-12.git
cd GhidraMCP-12

# Copy JARs from your Ghidra 12 installation
cp /Applications/Ghidra/Ghidra/Framework/Generic/lib/Generic.jar lib/
cp /Applications/Ghidra/Ghidra/Framework/SoftwareModeling/lib/SoftwareModeling.jar lib/
cp /Applications/Ghidra/Ghidra/Framework/Project/lib/Project.jar lib/
cp /Applications/Ghidra/Ghidra/Framework/Docking/lib/Docking.jar lib/
cp /Applications/Ghidra/Ghidra/Features/Decompiler/lib/Decompiler.jar lib/
cp /Applications/Ghidra/Ghidra/Framework/Utility/lib/Utility.jar lib/
cp /Applications/Ghidra/Ghidra/Features/Base/lib/Base.jar lib/
cp /Applications/Ghidra/Ghidra/Framework/Gui/lib/Gui.jar lib/

# Build
mvn clean package

# Output: target/GhidraMCP-2.0-ghidra12.zip

Troubleshooting

"No context found for request" (404 Error)

Make sure Ghidra is running with a program loaded
Verify the plugin is enabled in File → Configure → Developer
Check the port matches between Ghidra and the bridge script

Plugin Not Appearing

Verify you're using Ghidra 12.0.1
Check File → Install Extensions shows GhidraMCP as installed
Restart Ghidra completely after installation

Build Errors

If you see "Source option X is no longer supported":

Ensure you're using this fork's pom.xml with JDK 21 configuration
Verify JAVA_HOME points to JDK 21

API Endpoints

| Endpoint | Description | |----------|-------------| | /methods | List all methods/functions | | /decompile/{address} | Decompile function at address | | /rename/method | Rename a method | | /rename/variable | Rename a variable | | /classes | List all classes | | /imports | List all imports | | /exports | List all exports | | /symbols | List all symbols |

Credits

License

Apache License 2.0 - See LICENSE for details.

GhidraMCP