1. Home
  2. ghidraMCP
  3. ghidraMCP for Claude Code: Setup & Config

Data as of

ghidraMCP for Claude Code: Setup & Config

ghidraMCP connects Claude Code to core Ghidra analysis features through a plugin and Python bridge.

What you can do with ghidraMCP in Claude Code

Choose it to bring Ghidra decompilation and renaming into an assistant workflow through a plugin bridge.

  • Ask an assistant to decompile and inspect binaries in Ghidra.
  • Connect a running Ghidra instance to Claude Desktop or Cline.

Before you start: ghidraMCP in Claude Code

  • Ghidra
  • Python 3
  • MCP Python SDK
  • The installed and enabled GhidraMCP plugin
  • The Python bridge from a project release

Replace the README’s absolute-path placeholder with the bridge location. The HTTP URL is the bridge’s Ghidra backend, not a remote MCP endpoint. Cline can instead use the documented SSE bridge mode.

ghidraMCP Claude Code configuration

  1. Choose Claude Code configuration scope

    For ghidraMCP, open Project scope: .mcp.json at the repository root. Project JSON: merge into mcpServers; user scope: use the CLI.

  2. Add ghidraMCP to Claude Code

    Use the GhidraMCP entry below in mcpServers. Keep ghidraMCP's documented stdio connection fields and your other Claude Code entries.

  3. Check ghidraMCP in Claude Code

    ghidraMCP: Inspect claude mcp list and /mcp status.

Config file · Project scope: .mcp.json at the repository root

JSON
{
  "mcpServers": {
    "GhidraMCP": {
      "type": "stdio",
      "command": "python",
      "args": [
        "/ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py",
        "--ghidra-server",
        "http://127.0.0.1:8080/"
      ],
      "env": {}
    }
  }
}

CLI (POSIX shell)
claude mcp add-json --scope project 'GhidraMCP' '{"type":"stdio","command":"python","args":["/ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py","--ghidra-server","http://127.0.0.1:8080/"],"env":{}}'

Troubleshooting ghidraMCP in Claude Code

  • If ghidraMCP fails to start, check python (Python), the working directory, and Claude Code's selected scope; inspect claude mcp list and /mcp.
  • ghidraMCP uses stdio here: Claude Code must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
  • Known limitation: Requires Ghidra extension installation, restart, and plugin enablement.
  • Known limitation: Building from source requires Ghidra JAR files and Maven packaging.
  • Known limitation: Individual MCP tool identifiers are Not stated in the README.
  • General Claude Code troubleshooting lives in the /clients/claude-code guide.

ghidraMCP — details. Claude Code guide

Frequently asked questions

Register ghidraMCP with the displayed claude mcp add-json --scope project command, or merge the JSON into .mcp.json at the repository root.

Claude Code's GhidraMCP example uses stdio.

ghidraMCP's Claude Code configuration invokes python (Python).

Install the release extension, restart Ghidra, and enable GhidraMCPPlugin under the Developer configuration.

Yes. The Cline example manually starts the Python bridge with SSE transport and connects to its /sse endpoint.