원클릭으로 Manus에서 모든 스킬 실행

시작하기

ghidra-mcp-headless

스타3

포크0

업데이트2026년 6월 5일 20:42

Start GhidraMCP headless server with the Hamsterball.exe project — always do this before any RE work

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

evangit2

evangit2/hamsterball-re

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

GhidraMCP Headless Server Startup

One-Line Start

export GHIDRA_HOME=/opt/ghidra_12.0.4_PUBLIC
MCP_JAR=/home/evan/.config/ghidra/ghidra_12.0.4_PUBLIC/Extensions/GhidraMCP/lib/GhidraMCP-5.12.0.jar
CLASSPATH="$MCP_JAR"
for jar in $GHIDRA_HOME/Ghidra/Framework/*/lib/*.jar; do CLASSPATH="${CLASSPATH}:${jar}"; done
for jar in $GHIDRA_HOME/Ghidra/Features/*/lib/*.jar; do CLASSPATH="${CLASSPATH}:${jar}"; done
for jar in $GHIDRA_HOME/Ghidra/Processors/*/lib/*.jar; do CLASSPATH="${CLASSPATH}:${jar}"; done

nohup java -Xmx4g -XX:+UseG1GC \
    -Dghidra.home=$GHIDRA_HOME -Dapplication.name=GhidraMCP \
    -classpath "$CLASSPATH" \
    com.xebyte.headless.GhidraMCPHeadlessServer \
    --port 8089 --bind 127.0.0.1 \
    --project /home/evan/hamsterball-re/analysis/ghidra/HamsterballProject/Hamsterball.gpr \
    --program /Hamsterball.exe \
    > /tmp/ghidra-mcp.log 2>&1 &

echo "Started PID $!"
sleep 15
curl -s http://127.0.0.1:8089/health

Startup Checklist

Before doing ANY RE work:

Verify server is running: curl -s http://127.0.0.1:8089/health
Check program loaded: {"status":"healthy","version":"5.2.0-headless","program_loaded":true,"program_name":"Hamsterball.exe"}
Verify rename count: mcp_ghidra_mcp_compare_programs_documentation — should be ~75% if restored
If 40%: project was re-imported, restore from renames.json first

Startup Flags Reference

Flag	Required	Notes
`--port 8089`	Yes	Default port
`--bind 127.0.0.1`	Yes	Localhost only
`--project /path/Hamsterball.gpr`	Yes	Must end in `.gpr`
`--program /Hamsterball.exe`	Yes	Leading slash required
`-Xmx4g`	Recommended	Min 4GB heap
`-Dghidra.home`	Yes	Ghidra installation path

If Program Not Loaded

Error: program_loaded: false or Error loading program:

Check log: tail -20 /tmp/ghidra-mcp.log
If "No .gpr file found": wrong project path, must end in .gpr
If "Absolute path must begin with '/'": missing leading slash on --program
If "Import requires GUI mode": binary file path wrong, use --file for direct binary load

If Import Needed (Fresh Binary)

# Use analyzeHeadless to import first
export GHIDRA_HOME=/opt/ghidra_12.0.4_PUBLIC
$GHIDRA_HOME/support/analyzeHeadless \
    ~/hamsterball-re/analysis/ghidra/HamsterballProject \
    Hamsterball \
    -import ~/hamsterball-re/originals/installed/extracted/Hamsterball.exe \
    -overwrite \
    2>&1 | tail -10
# Then start MCP server with --program flag
# IMPORTANT: After re-import, ALL previous renames are LOST.
# Run ghidra-restore-renames skill to restore from FUNCTION_MAP.md

Server Maintenance

Stop server: kill $(pgrep -f GhidraMCPHeadlessServer)
Check logs: tail -f /tmp/ghidra-mcp.log
Restart if hung: kill, wait 2s, restart

MCP Tool Quick Reference

Task	Tool
List functions	`mcp_ghidra_mcp_list_functions_enhanced`
Rename function	`mcp_ghidra_mcp_rename_function_by_address`
Batch rename	`mcp_ghidra_mcp_batch_rename_function_components`
Search functions	`mcp_ghidra_mcp_search_functions_enhanced`
Get function info	`mcp_ghidra_mcp_analyze_function_complete`
Decompile	`mcp_ghidra_mcp_decompile_function`
Set comment	`mcp_ghidra_mcp_set_decompiler_comment`
Batch comments	`mcp_ghidra_mcp_batch_set_comments`
Get xrefs	`mcp_ghidra_mcp_get_bulk_xrefs`
Check progress	`mcp_ghidra_mcp_compare_programs_documentation`

Key Gotchas

NEVER start a session without checking program_loaded: true
NEVER assume renames survived a project re-import
The project path must end in .gpr (e.g., Hamsterball.gpr not HamsterballProject)
Program name must have leading slash: /Hamsterball.exe not Hamsterball.exe
Import via analyzeHeadless before starting MCP server for a new binary

이 저장소의 다른 Skills

같은 저장소

hamsterball-re

evangit2/hamsterball-re

Reverse engineer and recreate the Hamsterball game (2000s Windows game by Raptisoft)

2026-07-133

ghidra-restore-renames

evangit2/hamsterball-re

Restore all function renames from FUNCTION_MAP.md back into a fresh Ghidra project after DB loss or re-import

2026-06-053

hermes-agent

evangit2/hamsterball-re

Complete guide to using and extending Hermes Agent — CLI usage, setup, configuration, spawning additional agents, gateway platforms, skills, voice, tools, profiles, and a concise contributor reference. Load this skill when helping users configure Hermes, troubleshoot issues, spawn agent instances, or make code contributions.

2026-04-163

excalidraw

evangit2/hamsterball-re

Create hand-drawn style diagrams using Excalidraw JSON format. Generate .excalidraw files for architecture diagrams, flowcharts, sequence diagrams, concept maps, and more. Files can be opened at excalidraw.com or uploaded for shareable links.

2026-04-163

popular-web-designs

evangit2/hamsterball-re

54 production-quality design systems extracted from real websites. Load a template to generate HTML/CSS that matches the visual identity of sites like Stripe, Linear, Vercel, Notion, Airbnb, and more. Each template includes colors, typography, components, layout rules, and ready-to-use CSS values.

2026-04-163

d3d8-cross-compile-wine

evangit2/hamsterball-re

Cross-compile D3D8-based game with MinGW, test on Wine with OpenGL translation

2026-04-163

GhidraMCP Headless Server Startup

One-Line Start

export GHIDRA_HOME=/opt/ghidra_12.0.4_PUBLIC MCP_JAR=/home/evan/.config/ghidra/ghidra_12.0.4_PUBLIC/Extensions/GhidraMCP/lib/GhidraMCP-5.12.0.jar CLASSPATH="$MCP_JAR" for jar in $GHIDRA_HOME/Ghidra/Framework/*/lib/*.jar; do CLASSPATH="${CLASSPATH}:${jar}"; done for jar in $GHIDRA_HOME/Ghidra/Features/*/lib/*.jar; do CLASSPATH="${CLASSPATH}:${jar}"; done for jar in $GHIDRA_HOME/Ghidra/Processors/*/lib/*.jar; do CLASSPATH="${CLASSPATH}:${jar}"; done nohup java -Xmx4g -XX:+UseG1GC \ -Dghidra.home=$GHIDRA_HOME -Dapplication.name=GhidraMCP \ -classpath "$CLASSPATH" \ com.xebyte.headless.GhidraMCPHeadlessServer \ --port 8089 --bind 127.0.0.1 \ --project /home/evan/hamsterball-re/analysis/ghidra/HamsterballProject/Hamsterball.gpr \ --program /Hamsterball.exe \ > /tmp/ghidra-mcp.log 2>&1 & echo "Started PID $!" sleep 15 curl -s http://127.0.0.1:8089/health

Startup Checklist

Before doing ANY RE work:

Verify server is running: curl -s http://127.0.0.1:8089/health

Check program loaded: {"status":"healthy","version":"5.2.0-headless","program_loaded":true,"program_name":"Hamsterball.exe"}

Verify rename count: mcp_ghidra_mcp_compare_programs_documentation — should be ~75% if restored

If 40%: project was re-imported, restore from renames.json first

Startup Flags Reference

Flag

Required

Notes

--port 8089

Yes

Default port

--bind 127.0.0.1

Yes

Localhost only

--project /path/Hamsterball.gpr

Yes

Must end in .gpr

--program /Hamsterball.exe

Yes

Leading slash required

-Xmx4g

Recommended

Min 4GB heap

-Dghidra.home

Yes

Ghidra installation path

If Program Not Loaded

Error: program_loaded: false or Error loading program:

Check log: tail -20 /tmp/ghidra-mcp.log

If "No .gpr file found": wrong project path, must end in .gpr

If "Absolute path must begin with '/'": missing leading slash on --program

If "Import requires GUI mode": binary file path wrong, use --file for direct binary load

If Import Needed (Fresh Binary)

# Use analyzeHeadless to import first export GHIDRA_HOME=/opt/ghidra_12.0.4_PUBLIC $GHIDRA_HOME/support/analyzeHeadless \ ~/hamsterball-re/analysis/ghidra/HamsterballProject \ Hamsterball \ -import ~/hamsterball-re/originals/installed/extracted/Hamsterball.exe \ -overwrite \ 2>&1 | tail -10 # Then start MCP server with --program flag # IMPORTANT: After re-import, ALL previous renames are LOST. # Run ghidra-restore-renames skill to restore from FUNCTION_MAP.md

Server Maintenance

Stop server: kill $(pgrep -f GhidraMCPHeadlessServer)

Check logs: tail -f /tmp/ghidra-mcp.log

Restart if hung: kill, wait 2s, restart

MCP Tool Quick Reference

Task

Tool

List functions

mcp_ghidra_mcp_list_functions_enhanced

Rename function

mcp_ghidra_mcp_rename_function_by_address

Batch rename

mcp_ghidra_mcp_batch_rename_function_components

Search functions

mcp_ghidra_mcp_search_functions_enhanced

Get function info

mcp_ghidra_mcp_analyze_function_complete

Decompile

mcp_ghidra_mcp_decompile_function

Set comment

mcp_ghidra_mcp_set_decompiler_comment

Batch comments

mcp_ghidra_mcp_batch_set_comments

Get xrefs

mcp_ghidra_mcp_get_bulk_xrefs

Check progress

mcp_ghidra_mcp_compare_programs_documentation

Key Gotchas

NEVER start a session without checking program_loaded: true

NEVER assume renames survived a project re-import

The project path must end in .gpr (e.g., Hamsterball.gpr not HamsterballProject)

Program name must have leading slash: /Hamsterball.exe not Hamsterball.exe

Import via analyzeHeadless before starting MCP server for a new binary

name	ghidra-mcp-headless
description	Start GhidraMCP headless server with the Hamsterball.exe project — always do this before any RE work
version	"2026-04-13T00:00:00.000Z"