Skip to content
Back to search

ghidra-mcp

Headless PyGhidra MCP servers: FlexTalk, Creatures multi-project, and classic Mac 68k variants

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/h4rm0n1c--ghidra-mcp/badge.svg)](/listings/h4rm0n1c--ghidra-mcp)

HTML

<a href="/listings/h4rm0n1c--ghidra-mcp"><img src="/api/listings/h4rm0n1c--ghidra-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 57 lines
  1. # ghidra-mcp
  2. Three MCP server implementations for headless Ghidra. Each one has two parts:
  3. - `ghidra_headless_server.py` starts Ghidra's JVM through PyGhidra, opens a
  4. Ghidra project and serves a REST API.
  5. - `bridge_mcp_ghidra.py` is a FastMCP server. It exposes the REST API as MCP
  6. tools (stdio or SSE).
  7. No Ghidra GUI or Java plugin is necessary. The REST API is compatible with the
  8. GhidraMCP plugin API, and the server adds many more endpoints.
  9. | Folder | Instance | Default port | Description |
  10. | --- | --- | --- | --- |
  11. | `flextalk/` | `ghidra-mcp` | 8080 | First implementation, made for the FlexTalk TTS reverse-engineering project. Single project. |
  12. | `creatures/` | `ghidra-mcp-2` | 8082 | Isolated second instance, made for the Creatures reverse-engineering work. Multi-project (`projects.json`), program import, map-file symbols, GhidraScript runs, capability catalog, x86/MSVC tools (vtables, ECX/thiscall receivers, SEH, x87 stack, switch dispatch). |
  13. | `classic-mac/` | `oldmac-re` | 8084 | Classic Macintosh 68k variant. Merged from the two other servers (see `merge-manifest.json`), with x86-only tools removed and Mac resource-fork tools added. Includes the `ClassicMacLoader` Ghidra extension. |
  14. ## Requirements
  15. - Ghidra 12.1 (set `GHIDRA_INSTALL_DIR`)
  16. - Python 3.10 or later, in a venv with `pyghidra`, `mcp>=1.2.0,<2` and `requests`
  17. ## Run
  18. ```sh
  19. export GHIDRA_INSTALL_DIR=/opt/ghidra_12.1_PUBLIC
  20. python ghidra_headless_server.py --port 8082
  21. python bridge_mcp_ghidra.py --ghidra-server http://127.0.0.1:8082/
  22. ```
  23. The `*.init` files are the SysV init scripts used to run the servers as
  24. services. They contain local paths. Change them before you use them.
  25. ### creatures/
  26. `instance_config.py` reads its settings from `GHIDRA_MCP_*` environment
  27. variables. The server reads the project registry from `projects.json` next to
  28. the script. Copy `projects.example.json` to `projects.json` and set your
  29. project paths.
  30. ### classic-mac/
  31. `mcp_server.py` is the MCP entry point. It loads `vendor/bridge_mcp_ghidra.py`
  32. and adds the Mac tools. `service_manager.py` starts the REST server. It expects
  33. the original workspace layout (`MacRE/projects`), so you must change it for a
  34. different layout. Read `GUIDANCE.md` and `ADAPTATION.md` before you extend the
  35. tools. `fixtures/` has small 68k test binaries.
  36. ## Attribution
  37. - `bridge_mcp_ghidra.py` and the REST API come from
  38. [LaurieWired/GhidraMCP](https://github.com/LaurieWired/GhidraMCP)
  39. (Apache-2.0). They have been extended.
  40. - `classic-mac/ClassicMacLoader/` is a modified copy of the Classic Mac
  41. resource-fork loader from
  42. [hippietrail/RetroGhidra](https://github.com/hippietrail/RetroGhidra).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.