1. Home
  2. ghidraMCP
  3. ghidraMCP for Windsurf: Setup & Config

Data as of

ghidraMCP for Windsurf: Setup & Config

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

What you can do with ghidraMCP in Windsurf

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

  • Rename methods and data during reverse-engineering analysis.
  • Connect a running Ghidra instance to Claude Desktop or Cline.

Before you start: ghidraMCP in Windsurf

  • 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 Windsurf configuration

  1. Choose Windsurf configuration scope

    For ghidraMCP, open macOS/Linux: ~/.codeium/windsurf/mcp_config.json Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json. Merge into mcpServers; remote endpoints use serverUrl.

  2. Add ghidraMCP to Windsurf

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

  3. Check ghidraMCP in Windsurf

    ghidraMCP: Refresh MCP in Windsurf settings and inspect Cascade’s tools.

Config file · macOS/Linux: ~/.codeium/windsurf/mcp_config.json

Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

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

Troubleshooting ghidraMCP in Windsurf

  • Check python (Python) on the machine running Windsurf's MCP integration for ghidraMCP; refresh MCP and inspect Cascade's tools.
  • ghidraMCP uses stdio here: Windsurf 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 Windsurf troubleshooting lives in the /clients/windsurf guide.

ghidraMCP — details. Windsurf guide

Frequently asked questions

Windsurf reads ghidraMCP under mcpServers in ~/.codeium/windsurf/mcp_config.json on macOS/Linux; Windows uses %USERPROFILE%\.codeium\windsurf\mcp_config.json.

Windsurf's GhidraMCP example uses stdio.

ghidraMCP's Windsurf configuration invokes python (Python).

Yes. The README lists automatic renaming of methods and data as a feature.

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