GhidraMCP

GhidraMCP for Ghidra 12.0.1

  

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

• Ghidra 12.0.1
• JDK 21
• Python 3.8+
• MCP SDK

Installation

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

1. Install in Ghidra:

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

1. Restart Ghidra

1. Enable the Plugin:

   File → Configure → Developer → Enable GhidraMCPPlugin

1. 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)

1. Start the MCP server:

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

1. 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)

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

Plugin Not Appearing

1. Verify you're using Ghidra 12.0.1
2. Check File → Install Extensions shows GhidraMCP as installed
3. 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

• Original project: LaurieWired/GhidraMCP
• Ghidra: NSA/ghidra
• MCP: modelcontextprotocol

License

Apache License 2.0 - See LICENSE for details.