convez.ai
MCP Server
hjtrbo

PcmHackMCP

hjtrbo/PcmHackMCP

Ver no GitHub
InicialPluginScore · de 0 a 100

GhidraMCP fork (MCP server + Ghidra plugin) with a server-side run_python tool for bulk Ghidra reverse-engineering ops. Renamed to coexist with upstream; default port 8765.

Instalação

$npx convez-ai hjtrbo/PcmHackMCP

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
v1.0.1
Issues abertas
0
Contribuidores
11

README

A tradução para o português deste README ainda está na fila.

License

PcmHackMCP

PcmHackMCP is a fork of LaurieWired/GhidraMCP (Apache-2.0): a Model Context Protocol (MCP) server plus Ghidra plugin that lets MCP clients (Claude, etc.) drive Ghidra for reverse engineering.

It keeps all of the upstream tools and adds one thing: a server-side run_python tool that executes an arbitrary Jython script inside Ghidra in a single call. Bulk work - mass renames, xref sweeps, batch comments, applying data types over many addresses - runs as one loop inside Ghidra instead of thousands of individual MCP/HTTP round-trips. Only the printed result crosses the wire.

To run alongside the original GhidraMCP without clashing, every identifier is renamed and the default port is changed:

Upstream GhidraMCPPcmHackMCP
MCP server nameghidra-mcppcmhack-mcp
Ghidra module / extensionGhidraMCPPcmHackMCP
Java classcom.lauriewired.GhidraMCPPlugincom.pcmhack.mcp.PcmHackMCPPlugin
Default HTTP port80808765
MCP bridge scriptbridge_mcp_ghidra.pybridge_mcp_pcmhack.py

Features

  • Everything in upstream GhidraMCP (decompile, list/rename functions and data, imports/exports, xrefs, strings, set prototypes, and more).
  • run_python(code, timeout=600) - run an arbitrary Jython script server-side against the current program. Full GhidraScript environment is available (currentProgram, the flat API, monitor); a program transaction is opened and committed automatically; both print(...) and println(...) output is captured and returned.

Install

Prerequisites

  • Ghidra 11.3.2
  • Python 3.10+ and the MCP SDK: pip install "mcp>=1.2.0,<2" "requests>=2,<3"

Ghidra plugin

  1. Run Ghidra
  2. File -> Install Extensions
  3. Click + and select PcmHackMCP-11.3.2.zip
  4. Restart Ghidra
  5. Enable PcmHackMCP in File -> Configure -> Developer
  6. Optional: change the port in Edit -> Tool Options -> PcmHackMCP HTTP Server (default 8765)

MCP client (Claude Desktop example)

Claude -> Settings -> Developer -> Edit Config, then:

{
  "mcpServers": {
    "pcmhack": {
      "command": "py",
      "args": [
        "-3",
        "C:\\ABSOLUTE_PATH_TO\\bridge_mcp_pcmhack.py",
        "--ghidra-server",
        "http://127.0.0.1:8765/"
      ]
    }
  }
}

Host/port default to 127.0.0.1:8765 if not set.

Claude Code

claude mcp add pcmhack -- py -3 "C:\ABSOLUTE_PATH_TO\bridge_mcp_pcmhack.py"

run_python example

curl -s -X POST http://127.0.0.1:8765/run_python --data-binary @- <<'PY'
count = 0
for f in currentProgram.getFunctionManager().getFunctions(True):
    if f.getName().startswith("FUN_"):
        count += 1
print("auto-named functions:", count)
PY

The script runs inside Ghidra and returns its printed output.

Security: the embedded HTTP server binds to all interfaces and run_python executes arbitrary code in your Ghidra session. Run it only on a trusted network.

Claude Code skill

A Claude Code skill ships with this repo at .claude/skills/pcmhack-mcp/SKILL.md. It captures the discipline for writing good run_python payloads: the whole-script model, printing results as JSON, the automatic (commit-on-error) transaction, and the Jython 2.7 traps that bite. It loads automatically when you work with run_python.

Build from source

No Maven required (it is a single source file). With JDK 17-21:

  1. Copy these jars from your Ghidra install into lib/:
    • Base.jar, Decompiler.jar, Docking.jar, Generic.jar, Project.jar, SoftwareModeling.jar, Utility.jar, Gui.jar
  2. Compile and package:
    javac --release 17 -cp "lib/*" -d build/classes src/main/java/com/pcmhack/mcp/PcmHackMCPPlugin.java
    jar --create --file target/PcmHackMCP.jar --manifest src/main/resources/META-INF/MANIFEST.MF -C build/classes .
    
  3. Stage an extension folder target/ext/PcmHackMCP/ containing extension.properties, Module.manifest, and lib/PcmHackMCP.jar, then zip it with the jar tool:
    jar --create --file target/PcmHackMCP-11.3.2.zip -C target/ext PcmHackMCP
    
    Do not zip it with PowerShell Compress-Archive or .NET ZipFile.CreateFromDirectory - on Windows PowerShell 5.1 both write backslash zip entry paths, which Ghidra's installer rejects ("Unexpected error installing extension"). The jar tool writes forward-slash paths and directory entries, which Ghidra accepts.

Or, if you have Maven installed: mvn clean package assembly:single.

Credits

Fork of GhidraMCP by LaurieWired. Licensed under Apache-2.0; see LICENSE.

Ver o original no GitHub

Bom para

Relacionados