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.
Features
MCP Server + Ghidra Plugin
- Decompile and analyze binaries in Ghidra
- Automatically rename methods and data
- List methods, classes, imports, and exports
Installation
Prerequisites
- Install Ghidra
- Python3
- MCP SDK
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.
- Run Ghidra
- Select
File->Install Extensions
- Click the
+button
- Select the
GhidraMCP-1-2.zip(or your chosen version) from the downloaded release
- Restart Ghidra
- Make sure the GhidraMCPPlugin is enabled in
File->Configure->Developer
- Optional: Configure the port in Ghidra with
Edit->Tool Options->GhidraMCP HTTP Server
Video Installation Guide:
MCP Clients
Theoretically, any MCP client should work with ghidraMCP. Three examples are given below.
Example 1: Claude Desktop
To set up Claude Desktop as a Ghidra MCP client, go to
Claude -> Settings -> Developer -> Edit Config -> claude_desktop_config.json and add the following:Alternatively, edit this file directly:
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.
Example 2: Cline
To use GhidraMCP with Cline, this requires manually running the MCP server as well. First run the following command:
The only required argument is the transport. If all other arguments are unspecified, they will default to the above. Once the MCP server is running, open up Cline and select
MCP Servers at the top.Cline select
Then select
Remote Servers and add the following, ensuring that the url matches the MCP host and port:- Server Name: GhidraMCP
- Server URL:
http://127.0.0.1:8081/sse
Example 3: 5ire
Another MCP client that supports multiple models on the backend is 5ire. To set up GhidraMCP, open 5ire and go to
Tools -> New and set the following configurations:- Tool Key: ghidra
- Name: GhidraMCP
- Command:
python /ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py
Building from Source
- Copy the following files from your Ghidra directory to this project's
lib/directory:
Ghidra/Features/Base/lib/Base.jar
Ghidra/Features/Decompiler/lib/Decompiler.jar
Ghidra/Framework/Docking/lib/Docking.jar
Ghidra/Framework/Generic/lib/Generic.jar
Ghidra/Framework/Project/lib/Project.jar
Ghidra/Framework/SoftwareModeling/lib/SoftwareModeling.jar
Ghidra/Framework/Utility/lib/Utility.jar
Ghidra/Framework/Gui/lib/Gui.jar
- Build with Maven by running:
mvn clean package assembly:singleThe generated zip file includes the built Ghidra plugin and its resources. These files are required for Ghidra to recognize the new extension.
- lib/GhidraMCP.jar
- extensions.properties
- Module.manifest
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.
Features
MCP Server + Ghidra Plugin
- Decompile and analyze binaries in Ghidra
- Automatically rename methods and data
- List methods, classes, imports, and exports
Installation
Prerequisites
- Install Ghidra
- Python3
- MCP SDK
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.
- Run Ghidra
- Select
File->Install Extensions
- Click the
+button
- Select the
GhidraMCP-1-2.zip(or your chosen version) from the downloaded release
- Restart Ghidra
- Make sure the GhidraMCPPlugin is enabled in
File->Configure->Developer
- Optional: Configure the port in Ghidra with
Edit->Tool Options->GhidraMCP HTTP Server
Video Installation Guide:
MCP Clients
Theoretically, any MCP client should work with ghidraMCP. Three examples are given below.
Example 1: Claude Desktop
To set up Claude Desktop as a Ghidra MCP client, go to
Claude -> Settings -> Developer -> Edit Config -> claude_desktop_config.json and add the following:Alternatively, edit this file directly:
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.
Example 2: Cline
To use GhidraMCP with Cline, this requires manually running the MCP server as well. First run the following command:
The only required argument is the transport. If all other arguments are unspecified, they will default to the above. Once the MCP server is running, open up Cline and select
MCP Servers at the top.Cline select
Then select
Remote Servers and add the following, ensuring that the url matches the MCP host and port:- Server Name: GhidraMCP
- Server URL:
http://127.0.0.1:8081/sse
Example 3: 5ire
Another MCP client that supports multiple models on the backend is 5ire. To set up GhidraMCP, open 5ire and go to
Tools -> New and set the following configurations:- Tool Key: ghidra
- Name: GhidraMCP
- Command:
python /ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py
Building from Source
- Copy the following files from your Ghidra directory to this project's
lib/directory:
Ghidra/Features/Base/lib/Base.jar
Ghidra/Features/Decompiler/lib/Decompiler.jar
Ghidra/Framework/Docking/lib/Docking.jar
Ghidra/Framework/Generic/lib/Generic.jar
Ghidra/Framework/Project/lib/Project.jar
Ghidra/Framework/SoftwareModeling/lib/SoftwareModeling.jar
Ghidra/Framework/Utility/lib/Utility.jar
Ghidra/Framework/Gui/lib/Gui.jar
- Build with Maven by running:
mvn clean package assembly:singleThe generated zip file includes the built Ghidra plugin and its resources. These files are required for Ghidra to recognize the new extension.
- lib/GhidraMCP.jar
- extensions.properties
- Module.manifest