Ghidrassistmcp

🚀 GhidrAssistMCP

GhidrAssistMCP is a powerful Ghidra extension that offers an MCP (Model Context Protocol) server. It allows AI assistants and other tools to interact with Ghidra's reverse - engineering capabilities via a standardized API.

🚀 Quick Start

GhidrAssistMCP bridges the gap between AI - powered analysis tools and Ghidra's comprehensive reverse engineering platform. By implementing the Model Context Protocol, this extension enables external AI assistants, automated analysis tools, and custom scripts to seamlessly interact with Ghidra's analysis capabilities.

✨ Features

• MCP Server Integration: Full Model Context Protocol server implementation using official SDK.
• 31 Built - in Tools: A comprehensive set of analysis tools covering functions, data, cross - references, and more.
• Configurable UI: An easy - to - use interface for managing tools and monitoring activity.
• Real - time Logging: Track all MCP requests and responses with detailed logging.
• Dynamic Tool Management: Enable/disable tools individually with persistent settings.
• Current Context Awareness: Tools that understand Ghidra's current cursor position and active function.

📦 Installation

Prerequisites

• Ghidra 11.4+ (tested with Ghidra 11.4 Public).
• An MCP Client (Like GhidrAssist).

Binary Release (Recommended)

1. Download the latest release:
   • Go to the Releases page.
   • Download the latest .zip file (e.g., GhidrAssistMCP - v1.0.0.zip).
2. Install the extension:
   • In Ghidra: File → Install Extensions → Add Extension.
   • Select the downloaded ZIP file.
   • Restart Ghidra when prompted.
3. Enable the plugin:
   • File → Configure → Configure Plugins.
   • Search for "GhidrAssistMCP".
   • Check the box to enable the plugin.

Building from Source

1. Clone the repository:

   git clone <repository - url>
   cd GhidrAssistMCP
   

2. Set Ghidra installation path:

   export GHIDRA_INSTALL_DIR=/path/to/your/ghidra/installation
   

3. Build the extension:

   gradle buildExtension
   

4. Install the extension:
   • Copy the generated ZIP file from dist/ directory.
   • In Ghidra: File → Install Extensions → Add Extension.
   • Select the ZIP file and restart Ghidra.
5. Enable the plugin:
   • File → Configure → Configure Plugins.
   • Search for "GhidrAssistMCP".
   • Check the box to enable the plugin.

💻 Usage Examples

Basic Usage

{
  "method": "tools/call",
  "params": {
    "name": "get_program_info"
  }
}

Advanced Usage

Function Analysis

{
  "method": "tools/call",
  "params": {
    "name": "get_function_info",
    "arguments": {
      "function_name": "main"
    }
  }
}

Decompilation

{
  "method": "tools/call",
  "params": {
    "name": "decompile_function",
    "arguments": {
      "function_name": "encrypt_data"
    }
  }
}

Structure Creation

{
  "method": "tools/call",
  "params": {
    "name": "auto_create_struct",
    "arguments": {
      "function_identifier": "0x00401000",
      "variable_name": "ctx"
    }
  }
}

Setting Function Prototype

{
  "method": "tools/call",
  "params": {
    "name": "set_function_prototype",
    "arguments": {
      "function_address": "0x00401000",
      "prototype": "int main(int argc, char** argv)"
    }
  }
}

📚 Documentation

Configuration

Initial Setup

1. Open the Control Panel:
   • Window → GhidrAssistMCP (or use the toolbar icon).
2. Configure Server Settings:
   • Host: Default is localhost.
   • Port: Default is 8080.
   • Enable/Disable: Toggle the MCP server on/off.

Tool Management

The Configuration tab allows you to:

• View all available tools (31 total).
• Enable/disable individual tools using checkboxes.
• Save configuration to persist across sessions.
• Monitor tool status in real - time.

Available Tools

Architecture

Core Components

GhidrAssistMCP/
├── GhidrAssistMCPPlugin      # Main plugin entry point
├── GhidrAssistMCPServer      # HTTP/SSE MCP server
├── GhidrAssistMCPBackend     # Tool management and execution
├── GhidrAssistMCPProvider    # UI component provider
└── tools/                    # Individual MCP tools
    ├── Analysis Tools/
    ├── Modification Tools/
    └── Navigation Tools/

MCP Protocol Implementation

• Transport: HTTP with Server - Sent Events (SSE).
• Endpoints:
  • GET /sse - SSE connection for bidirectional communication.
  • POST /message - Message exchange endpoint.
• Tool Registration: Dynamic tool discovery and registration.
• Session Management: Stateful sessions with proper lifecycle management.

Plugin Architecture

1. Observer Pattern: Decoupled UI updates using event listeners.
2. Transaction Management: Safe database operations with rollback support.
3. Tool Registry: Dynamic tool registration with enable/disable capability.
4. Settings Persistence: Configuration saved in Ghidra's settings system.
5. Thread Safety: Proper Swing EDT handling for UI operations.

Development

Project Structure

src/main/java/ghidrassistmcp/
├── GhidrAssistMCPPlugin.java      # Main plugin class
├── GhidrAssistMCPProvider.java    # UI provider with tabs
├── GhidrAssistMCPServer.java      # MCP server implementation
├── GhidrAssistMCPBackend.java     # Backend tool management
├── McpBackend.java                # Backend interface
├── McpTool.java                   # Tool interface
├── McpEventListener.java          # Event notification interface
└── tools/                         # Tool implementations
    ├── ProgramInfoTool.java
    ├── ListFunctionsTool.java
    ├── DecompileFunctionTool.java
    ├── AutoCreateStructTool.java
    └── ... (29 total tools)

Adding New Tools

1. Implement McpTool interface:

   public class MyCustomTool implements McpTool {
       @Override
       public String getName() { return "my_custom_tool"; }
       
       @Override
       public String getDescription() { return "Description"; }
       
       @Override
       public McpSchema.JsonSchema getInputSchema() { /* ... */ }
       
       @Override
       public McpSchema.CallToolResult execute(Map<String, Object> arguments, Program program) {
           // Implementation
       }
   }
   

2. Register in backend:

   // In GhidrAssistMCPBackend constructor
   registerTool(new MyCustomTool());
   

Build Commands

# Clean build
gradle clean

# Build extension
gradle buildExtension

# Build with specific Ghidra path
gradle -PGHIDRA_INSTALL_DIR=/path/to/ghidra buildExtension

# Debug build
gradle buildExtension --debug

Dependencies

Logging

UI Logging

The Log tab provides real - time monitoring:

• Session Events: Server start/stop, program changes.
• Tool Requests: REQ: tool_name {parameters...}.
• Tool Responses: RES: tool_name {response...}.
• Error Messages: Failed operations and diagnostics.

Console Logging

Detailed logging in Ghidra's console:

• Tool registration and initialization.
• MCP server lifecycle events.
• Database transaction operations.
• Error stack traces and debugging information.

Troubleshooting

Common Issues

Debug Mode

Enable debug logging by adding to Ghidra startup:

-Dlog4j.logger.ghidrassistmcp=DEBUG

Contributing

1. Fork the repository.
2. Create a feature branch: git checkout -b feature - name.
3. Make your changes with proper tests.
4. Follow code style: Use existing patterns and conventions.
5. Submit a pull request with detailed description.

Code Standards

• Java 21+ features where appropriate.
• Proper exception handling with meaningful messages.
• Transaction safety for all database operations.
• Thread safety for UI operations.
• Comprehensive documentation for public APIs.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• NSA/Ghidra Team for the excellent reverse engineering platform.
• Anthropic for the Model Context Protocol specification.

Questions or Issues?

Please open an issue on the project repository for bug reports, feature requests, or questions about usage and development.