能做什么
Unified Ghidra + BizHawk MCP server for static analysis, P-code emulation, and retro ROM triage.
作者提供的原文
- 连接方式 在你的电脑上运行
- 账号或密钥 无需密钥 · 需填写 1 项设置(GHIDRA_INSTALL_DIR)
- 分类 开发者工具
可搭配使用
教 AI 做这类工作的 Skill,可与本项一起使用
andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
graphify
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
为什么排在这里
列表按使用分(满分 100)排序,由以下部分组成
| 热度 | 4/80 | GitHub 星标或每周下载量:较大的计 60,较小的计 20 |
|---|---|---|
| 新鲜度 | 7/12 | 30 天内有发布或代码更新得满分 |
| 仍在响应 | 0/8 | 上次检查时云端端点有响应 |
| 使用分 | 11/100 |
质量: 基础检查通过 3/3 项(仅展示,不用于排序) · 上升势头: 暂无数据 (只用于“上升中”标签)
安装
选择你使用的 AI 应用,然后复制设置。
用一句话让 AI 帮你安装
请帮我安装 Ghidra BizHawk MCP。按照 https://mcp.popnx.com/i/getanirao-ghidra-bizhawk-mcp.md 操作,先把命令给我看,等我同意后再运行。粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 AI 会读取的全文
通过 3/3 项检查 · 在你的电脑上运行 · ✓ 命令已检查 2026年11月14日
第一步:你用哪个 AI?
选择你用的应用,步骤会显示在下方。
可连接 Claude,但需要先准备
需要填写 1 项设置(GHIDRA_INSTALL_DIR) · 需要先在电脑上安装 Python (uv)(只需一次) · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用
让 AI 帮你安装
把这段话复制到 Claude 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。
请在这台电脑上为 Claude 安装 MCP server Ghidra BizHawk MCP,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):{ "mcpServers": { "ghidra-bizhawk": { "command": "uvx", "args": [ "ghidra-bizhawk-mcp" ], "env": { "GHIDRA_INSTALL_DIR": "your-value" } } } } 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) GHIDRA_INSTALL_DIR 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 Ghidra BizHawk MCP 的工具真的出现了。这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。
安装 uv(如果还没有)
已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter
uv --version- 显示版本号(例如 uv …)= 已安装,可跳过这一步
- 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
怎么打开终端
Mac:按 ⌘ + Space,输入 Terminal 后按 Enter
Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”
还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载
装好后关掉终端再打开,重新运行同一条命令,应显示版本号:
uv --version安装一次,所有需要 uv 的工具都能用
填写 1 项设置
这些是程序设置,不是密钥,无需注册。按开发者的说明填写。
GHIDRA_INSTALL_DIRGhidra 安装目录的绝对路径。查看英文原文
Absolute path to the Ghidra installation directory
说明为自动翻译,变量名保持原样;不确定时请查看原文。
打开电脑版 Claude 应用的设置文件
SettingsDeveloperEdit Config
粘贴这些设置并保存文件
{ "mcpServers": { "ghidra-bizhawk": { "command": "uvx", "args": [ "ghidra-bizhawk-mcp" ], "env": { "GHIDRA_INSTALL_DIR": "your-value" } } } }退出 Claude 再重新打开
试一试
用 Ghidra BizHawk MCP 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude 说正在使用 Ghidra BizHawk MCP,或回答中出现 Ghidra BizHawk MCP 的工具名称,就表示连接成功
2 项可选设置(不填也能用)
上面的命令不填这些也能用。想调整时再按开发者的说明添加。
BIZHAWK_EXE_PATH用于实时模拟功能的 EmuHawk.exe 的可选路径查看英文原文
Optional path to EmuHawk.exe for live emulation featuresMOCK_MODESet to 1 for zero-dependency CI simulation · 默认值 0
说明为自动翻译,变量名保持原样;不确定时请查看原文。
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
ChatGPT 暂时无法连接 Ghidra BizHawk MCP
Ghidra BizHawk MCP 需要安装在你的电脑上,而 ChatGPT 只能连接在网上运行的服务器
你可以改用这些方式
A · 使用能连接 Ghidra BizHawk MCP 的应用
- 需要填写 1 项设置(GHIDRA_INSTALL_DIR) · 需要先在电脑上安装 Python (uv)(只需一次) · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用
- 需要填写 1 项设置(GHIDRA_INSTALL_DIR) · 需要先在电脑上安装 Python (uv)(只需一次)
- 需要填写 1 项设置(GHIDRA_INSTALL_DIR) · 需要先在电脑上安装 Python (uv)(只需一次)
- 需要填写 1 项设置(GHIDRA_INSTALL_DIR) · 需要先在电脑上安装 Python (uv)(只需一次)
B · 开发者工具 类中能连接 ChatGPT 的其他服务器
从同类中使用较多的里挑选,仅限用地址即可连接、无需密钥的
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
可连接 Claude Code,但需要先准备
需要填写 1 项设置(GHIDRA_INSTALL_DIR) · 需要先在电脑上安装 Python (uv)(只需一次)
让 AI 帮你安装
把这段话复制到 Claude Code 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。
请在这台电脑上为 Claude Code 安装 MCP server Ghidra BizHawk MCP,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):claude mcp add --scope user ghidra-bizhawk --env GHIDRA_INSTALL_DIR=your-value -- uvx ghidra-bizhawk-mcp 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) GHIDRA_INSTALL_DIR 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 Ghidra BizHawk MCP 的工具真的出现了。这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。
安装 uv(如果还没有)
已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter
uv --version- 显示版本号(例如 uv …)= 已安装,可跳过这一步
- 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
怎么打开终端
Mac:按 ⌘ + Space,输入 Terminal 后按 Enter
Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”
还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载
装好后关掉终端再打开,重新运行同一条命令,应显示版本号:
uv --version安装一次,所有需要 uv 的工具都能用
填写 1 项设置
这些是程序设置,不是密钥,无需注册。按开发者的说明填写。
GHIDRA_INSTALL_DIRGhidra 安装目录的绝对路径。查看英文原文
Absolute path to the Ghidra installation directory
说明为自动翻译,变量名保持原样;不确定时请查看原文。
打开终端
Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell
粘贴这条命令并按 Enter
claude mcp add --scope user ghidra-bizhawk --env GHIDRA_INSTALL_DIR=your-value -- uvx ghidra-bizhawk-mcp在 Claude Code 中输入 /mcp
应能看到 Ghidra BizHawk MCP 在列表中并显示已连接
试一试
用 Ghidra BizHawk MCP 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude Code 说正在使用 Ghidra BizHawk MCP,或回答中出现 Ghidra BizHawk MCP 的工具名称,就表示连接成功
2 项可选设置(不填也能用)
上面的命令不填这些也能用。想调整时再按开发者的说明添加。
BIZHAWK_EXE_PATH用于实时模拟功能的 EmuHawk.exe 的可选路径查看英文原文
Optional path to EmuHawk.exe for live emulation featuresMOCK_MODESet to 1 for zero-dependency CI simulation · 默认值 0
说明为自动翻译,变量名保持原样;不确定时请查看原文。
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Cursor,但需要先准备
需要填写 1 项设置(GHIDRA_INSTALL_DIR) · 需要先在电脑上安装 Python (uv)(只需一次)
让 AI 帮你安装
把这段话复制到 Cursor 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。
请在这台电脑上为 Cursor 安装 MCP server Ghidra BizHawk MCP,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):{ "mcpServers": { "ghidra-bizhawk": { "command": "uvx", "args": [ "ghidra-bizhawk-mcp" ], "env": { "GHIDRA_INSTALL_DIR": "your-value" } } } } 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) GHIDRA_INSTALL_DIR 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 Ghidra BizHawk MCP 的工具真的出现了。这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。
安装 uv(如果还没有)
已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter
uv --version- 显示版本号(例如 uv …)= 已安装,可跳过这一步
- 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
怎么打开终端
Mac:按 ⌘ + Space,输入 Terminal 后按 Enter
Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”
还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载
装好后关掉终端再打开,重新运行同一条命令,应显示版本号:
uv --version安装一次,所有需要 uv 的工具都能用
填写 1 项设置
这些是程序设置,不是密钥,无需注册。按开发者的说明填写。
GHIDRA_INSTALL_DIRGhidra 安装目录的绝对路径。查看英文原文
Absolute path to the Ghidra installation directory
说明为自动翻译,变量名保持原样;不确定时请查看原文。
填写你的密钥
在 Ghidra BizHawk MCP 的设置中,GHIDRA_INSTALL_DIR 还是空的,填入你的密钥并保存
在 Cursor 中以 Agent 模式打开 AI 聊天
试一试
用 Ghidra BizHawk MCP 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Cursor 说正在使用 Ghidra BizHawk MCP,或回答中出现 Ghidra BizHawk MCP 的工具名称,就表示连接成功
2 项可选设置(不填也能用)
上面的命令不填这些也能用。想调整时再按开发者的说明添加。
BIZHAWK_EXE_PATH用于实时模拟功能的 EmuHawk.exe 的可选路径查看英文原文
Optional path to EmuHawk.exe for live emulation featuresMOCK_MODESet to 1 for zero-dependency CI simulation · 默认值 0
说明为自动翻译,变量名保持原样;不确定时请查看原文。
菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同
可连接 VS Code,但需要先准备
需要填写 1 项设置(GHIDRA_INSTALL_DIR) · 需要先在电脑上安装 Python (uv)(只需一次)
让 AI 帮你安装
把这段话复制到 VS Code 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。
请在这台电脑上为 VS Code 安装 MCP server Ghidra BizHawk MCP,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):{ "servers": { "ghidra-bizhawk": { "type": "stdio", "command": "uvx", "args": [ "ghidra-bizhawk-mcp" ], "env": { "GHIDRA_INSTALL_DIR": "your-value" } } } } 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) GHIDRA_INSTALL_DIR 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 Ghidra BizHawk MCP 的工具真的出现了。这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。
安装 uv(如果还没有)
已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter
uv --version- 显示版本号(例如 uv …)= 已安装,可跳过这一步
- 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
怎么打开终端
Mac:按 ⌘ + Space,输入 Terminal 后按 Enter
Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”
还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载
装好后关掉终端再打开,重新运行同一条命令,应显示版本号:
uv --version安装一次,所有需要 uv 的工具都能用
填写 1 项设置
这些是程序设置,不是密钥,无需注册。按开发者的说明填写。
GHIDRA_INSTALL_DIRGhidra 安装目录的绝对路径。查看英文原文
Absolute path to the Ghidra installation directory
说明为自动翻译,变量名保持原样;不确定时请查看原文。
填写你的密钥
在 Ghidra BizHawk MCP 的设置中,GHIDRA_INSTALL_DIR 还是空的,填入你的密钥并保存
在 VS Code 中以 Agent 模式打开 AI 聊天
试一试
用 Ghidra BizHawk MCP 告诉我你能帮我做什么,然后做一件给我看✓ 如果 VS Code 说正在使用 Ghidra BizHawk MCP,或回答中出现 Ghidra BizHawk MCP 的工具名称,就表示连接成功
2 项可选设置(不填也能用)
上面的命令不填这些也能用。想调整时再按开发者的说明添加。
BIZHAWK_EXE_PATH用于实时模拟功能的 EmuHawk.exe 的可选路径查看英文原文
Optional path to EmuHawk.exe for live emulation featuresMOCK_MODESet to 1 for zero-dependency CI simulation · 默认值 0
说明为自动翻译,变量名保持原样;不确定时请查看原文。
菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同
开发者专用:终端命令和 JSON 设置
安装在电脑上
Claude Code
claude mcp add --scope user ghidra-bizhawk --env GHIDRA_INSTALL_DIR=your-value -- uvx ghidra-bizhawk-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"ghidra-bizhawk": {
"command": "uvx",
"args": [
"ghidra-bizhawk-mcp"
],
"env": {
"GHIDRA_INSTALL_DIR": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"ghidra-bizhawk": {
"command": "uvx",
"args": [
"ghidra-bizhawk-mcp"
],
"env": {
"GHIDRA_INSTALL_DIR": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"ghidra-bizhawk": {
"type": "stdio",
"command": "uvx",
"args": [
"ghidra-bizhawk-mcp"
],
"env": {
"GHIDRA_INSTALL_DIR": "your-value"
}
}
}
}需要你填写的值
GHIDRA_INSTALL_DIR必填 envGhidra 安装目录的绝对路径。查看英文原文
Absolute path to the Ghidra installation directoryBIZHAWK_EXE_PATHenv用于实时模拟功能的 EmuHawk.exe 的可选路径查看英文原文
Optional path to EmuHawk.exe for live emulation featuresMOCK_MODEenvSet to 1 for zero-dependency CI simulation
说明为自动翻译,变量名保持原样;不确定时请查看原文。
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
一览
哪些应用可以使用它
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
在你的电脑上运行,适用于
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
它能做什么
它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月20日
- ✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 getanirao 验证,该账户拥有此仓库
- ✓ 通过
仍在维护
代码最后更新于35天前
- ✓ 通过
有许可证
使用 Apache-2.0
- – 不适用
端点有响应
它在你的电脑上运行,没有互联网端点
- – 不适用
使用 OAuth 登录
在你的电脑上运行,改用本地设置
- … 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行;我们只能读取互联网端点的工具列表
已公开的漏洞(OSV.dev)
OSV.dev 中没有 ghidra-bizhawk-mcp@1.1.0 的记录
只检查这个版本的包本身,不包括所有依赖 · 检查于 2026年11月15日
作者:申请重新检查或报告信息错误
给作者:在 README 中加徽章
如果你是作者,可把这段代码贴到 README。徽章会链接回本页。
[](https://mcp.popnx.com/en/servers/getanirao-ghidra-bizhawk-mcp)讨论
提问、分享技巧或报告无法使用。按“有帮助”数量排序。
用户评价
还没有评价
与“开发者工具”中的其他服务器比较i
- 星标数多于此分类中其他 6209 个服务器的 69%
- 发布到注册中心的时间比此分类中其他 6209 个服务器的 47% 更新
- 基础检查结果等于或优于此分类中其他 6209 个服务器的 99%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
Ghidra BizHawk MCP 安全吗?
它在 3 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
它在我的电脑上运行还是在云端?
它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。
它还在维护吗?
GitHub 仓库最后更新于35天前,最新版本(1.1.0)于35天前进入注册中心。
哪些应用可以使用它?
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Python (uv)。
有什么可以替代它?
同一分类中有:GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
功能相近的其他选择
同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| 本项 Ghidra BizHawk MCP | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| 运行位置 | 需要安装在电脑上 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 云端或安装在电脑上都可以 |
| 需要密钥 | 否 | 否 | 否 | 否 | 否 | 否 |
| 可在 Claude 中按 + 添加 | 否 | 否 | 否 | 是 | 否 | 否 |
| 基础检查 | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| 许可证 | Apache-2.0 | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| 价格 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 |
作者的 README
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
Ghidra BizHawk MCP
A unified MCP (Model Context Protocol) server bridging Ghidra's headless static analysis with BizHawk's live emulation — switch between decompiling a ROM and running it on real hardware in the same session.
GBA ROMs: If analyzing Game Boy Advance ROMs, install pudii/gba-ghidra-loader in your Ghidra installation for proper ROM header parsing, mirrored memory regions, and I/O register maps. The loader repository has pre-built
.gpafiles for Ghidra 11.x.
Prerequisites
| Dependency | Version | Required | Notes |
|---|---|---|---|
| Python | >= 3.10 | Yes | Runtime for the MCP server |
| Ghidra | 11.x or 12.x | Yes | Headless or GUI install; GHIDRA_INSTALL_DIR must point here |
| Java (JDK) | >= 17 | Yes | Bundled with Ghidra; needed for JVM bridge |
| pyghidra | >= 3.0 | Yes | Python-to-Ghidra bridge; installed automatically |
| BizHawk (EmuHawk) | Latest stable | No | Only needed for live emulation tools; BIZHAWK_EXE_PATH optional |
| Docker | Latest | No | Only needed for containerized deployment |
Architecture
┌─────────────────────────────────────────────────────────────────┐
│ MCP Client (Claude / Cursor) │ │ sends JSON-RPC over stdin/stdout │ └─────────────────────────────┬───────────────────────────────────┘ │ ▼ ┌──────────────────────────────────────────────────────────────────┐ │ ghidra-bizhawk-mcp │ │ ┌─────────────────────────────────────────────────────────────┐│ │ │ MCP Server (server.py) — tool registry, stdio dispatch ││ │ └──────────────────────────┬──────────────────────────────────┘│ │ │ │ │ ┌──────────────┴──────────────┐ │ │ ▼ ▼ │ │ ┌────────────────────┐ ┌──────────────────────────────┐ │ │ │ GhidraSession │ │ BizhawkBridge │ │ │ │ pyghidra → JVM │ │ TCP client → localhost:8766│ │ │ │ decompile, etc. │ └──────────────┬───────────────┘ │ │ └────────────────────┘ │ │ └───────────────────────────────────────────┼─────────────────────┘ │ TCP (newline-delimited JSON) ▼ ┌──────────────────────────────┐ │ BizHawk (EmuHawk.exe) │ │ built-in socket server │ │ ┌────────────────────────┐ │ │ │ bridge.lua │ │ │ │ memory read/write │ │ │ │ joypad, savestate │ │ │ │ frame advance │ │ │ └────────────────────────┘ │ └──────────────────────────────┘
Security Model
The MCP server communicates with the MCP client exclusively over stdin/stdout — no HTTP or network listener. The only local TCP socket is a loopback-only connection (127.0.0.1:8766) between the server and BizHawk's built-in Lua socket server. This is used solely for live-emulation features and is not exposed to the network.
Hardware & Retro Ecosystem Integration
ghidra-bizhawk-mcp includes native out-of-the-box support for retro-reversing automation pipelines via Ghidra's static analysis, plus live emulation via BizHawk's multi-system emulator. The server bundles:
- Nintendo Entertainment System (NES) via
GhidraNes - Super Nintendo Entertainment System (SNES) via native 65816 memory maps
- Game Boy Advance (GBA) via
gba-ghidra-loader - Nintendo DS (NDS) via
NTRGhidra - Nintendo Switch via
ghidra-switch-loader - PlayStation 1 (PSX) via
ghidra_psx_ldr - Sega Genesis / Mega Drive via native 68000 memory maps
- Sega Master System / Game Gear via
Ghidra-SegaMasterSystem-Loader - Sega Dreamcast via native SuperH4 memory maps
Zero-Input Triage — Worked Example (GBA)
The primary entry point is triage_and_load_retro_rom. Call it with any ROM path and the server handles the rest:
# Auto-detect platform, map language, provision session
triage_and_load_retro_rom(rom_path="/data/game.gba")
→ platform: "Game Boy Advance (GBA)"
→ loader: "GBA ROM Loader"
→ arch: "ARM:LE:32:v4t"
Decompile the main entry point on the same session
decompile_function(address="0x00001c2c")
→ decompiled C code for the GBA ROM entry routine
Search for a known pattern (e.g. 32-bit ARM store-multiple)
search_bytes(pattern="09 08 00 01")
→ matching addresses labelled "gba_ram_start"
Execution Chaining Flow
Instead of forcing your AI agent to spend cycles manually identifying architecture maps, register layouts, or memory segments, chain the automated ingestion pipeline:
- Invoke
triage_and_load_retro_romwith a target file path. - The server headlessly parses the binary file structure (
NES\x1a,NTR,NSO0,GBA, SNES title vectors,PS-X EXE,SEGA,TMR SEGA,SEGA ENTERPRISES), binds the matching Ghidra language module (6502:LE:16,ARM:LE:32:v4t,AARCH64:LE:64,65816:LE:24,MIPS:LE:32,68000:BE:32,Z80:16,SuperH4:LE:32), loads standard address memory blocks, and links automated signature cache arrays. - Use the integrated
emulate_sliceoremulate_slice_with_tainttools to analyze localized console loops — no physical console hardware or open GDB networking ports needed.
Triage Tool
| Tool | Description |
|---|---|
triage_and_load_retro_rom | Reads raw file magic bytes to detect NES, SNES, GBA, NDS, Switch, PSX, Genesis, SMS, or Dreamcast ROMs. Provisions a correctly-language-mapped Ghidra session and auto-restores cached function signatures. Returns platform, loader, architecture tag, and mapped memory blocks. |
Quick Start
1. Install
pip install ghidra-bizhawk-mcp
Or from source:
git clone https://github.com/getanirao/ghidra-bizhawk-mcp.git
cd ghidra-bizhawk-mcp pip install -e .
2. Set environment
# Required: point to your Ghidra installation
export GHIDRA_INSTALL_DIR=/opt/ghidra_11.2 # Linux / macOS set GHIDRA_INSTALL_DIR=C:\Program Files\ghidra_11.2 # Windows
Optional: enable live BizHawk emulation
export BIZHAWK_EXE_PATH=/path/to/EmuHawk.exe
Optional: run in mock mode (no Ghidra/BizHawk needed)
export MOCK_MODE=1
3. Run
ghidra-bizhawk-mcp
The server listens on stdin/stdout — pipe it to any MCP-compatible client.
Docker
docker build -t ghidra-bizhawk-mcp .
docker run -i --rm -v /path/to/binaries:/data ghidra-bizhawk-mcp
The container bundles JDK 17, Ghidra 11.2, and the server — no host dependencies beyond Docker.
Configuration
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
GHIDRA_INSTALL_DIR | Yes | — | Path to Ghidra installation (e.g. /opt/ghidra_11.2) |
BIZHAWK_EXE_PATH | No | — | Path to EmuHawk.exe for live emulation features |
MOCK_MODE | No | 0 | Set to 1 to run without Ghidra/BizHawk (for testing/CI) |
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": { "ghidra-bizhawk": { "command": "ghidra-bizhawk-mcp", "env": { "GHIDRA_INSTALL_DIR": "/opt/ghidra_11.2" } } } }
Cursor
Add to your Cursor MCP configuration:
{
"mcpServers": { "ghidra-bizhawk": { "command": "ghidra-bizhawk-mcp", "env": { "GHIDRA_INSTALL_DIR": "/opt/ghidra_11.2" } } } }
Tools
Session management
| Tool | Description |
|---|---|
analyze_binary | Import + analyze a binary, returns a session_id. Reuses the ID if provided, otherwise auto-generates. |
list_sessions | List all active workspaces with their session IDs, binary paths, and load times. |
close_session | Close a session and free its Ghidra project resources. |
Most tools accept an optional session_id parameter — omit it to use the most recently loaded session.
Read / Analysis
| Tool | Description |
|---|---|
decompile_function | Decompile a function by name or address. |
decompile_function_paginated | Decompile with line_start, line_end, max_tokens (token-budget truncation), and summarize (strips boilerplate locals + collapsing blank lines). Prevents context-window exhaustion. |
get_data_types | List all data types defined in the program. |
get_cross_references | Cross-references to/from an address. |
get_call_graph | Recursive call graph + callers for a function. |
analyze_and_decompile_entrypoints | Composite — bulk decompile all entry points (program entry, exports, main, _start, etc.) in one call. |
generate_workspace_report | Produce a Markdown summary of the active workspace — entry points, function count, custom symbols, recovered structures, renamed functions, comments. Replaces a GUI CodeBrowser window. |
Write / Mutation
| Tool | Description |
|---|---|
rename_symbol | Rename a function or label. Stored in the Ghidra project DB. |
add_comment | Attach a comment (plate, pre, post, eol, repeatable). |
create_struct | Create a custom structured data type from a JSON member layout [{offset, name, type}, ...]. Offsets are optional. |
retype_variable | Re-type a local variable or function parameter (e.g. undefined4* → MyStruct*). |
Assembly-level
| Tool | Description |
|---|---|
disassemble_range | Disassemble N raw instructions at an address — returns mnemonic, operands, hex bytes, and length for precise lower-level inspection. |
get_listing_range | Raw hex + ASCII dump for a byte range, equivalent to Ghidra's Listing panel. Complements disassemble_range for data regions. |
Byte-sequence search
| Tool | Description |
|---|---|
search_bytes | Search the entire binary for a hex byte pattern (e.g. 09 08 00 01 or F86D0003). Returns matching addresses with context bytes and any string label at the hit. |
Binary diffing
| Tool | Description |
|---|---|
diff_binaries | Compare two loaded sessions by function name and body size. Returns functions unique to each side and changed functions. |
Workspace Sessions
Each analyze_binary call creates a named session. Sessions keep their Ghidra project open independently, so multiple binaries can be loaded concurrently:
# Load two binaries into separate sessions
s1 = analyze_binary(binary_path="/bin/a.out") # auto session_id s2 = analyze_binary(binary_path="/bin/b.out", session_id="my_session")
Operate on a specific session
decompile_function(function_name="main", session_id=s1.session_id)
Diff them
diff_binaries(session_a=s1.session_id, session_b="my_session")
Deployment
Docker (multi-user / CI)
docker build -t ghidra-bizhawk-mcp .
Run as an MCP subprocess
docker run -i --rm \ -v /data/binaries:/data \ ghidra-bizhawk-mcp \ --ghidra-dir /opt/ghidra
The Dockerfile bundles Ghidra 11.2 and JDK 17 in a slim Python 3.11 image. Bind-mount your binaries directory at runtime.
MCP Bundle (MCPB — Claude Desktop / Smithery)
Package as a portable .mcpb bundle for one-click install in Claude Desktop or publishing on Smithery.
Prerequisites: Install the MCPB CLI:
npm install -g @anthropic-ai/mcpb
Build the bundle:
# From the repo root — also builds the Smithery publish variant
scripts/build-mcpb.ps1
Or manually with mcpb:
mcpb pack
The output ghidra-bizhawk-mcp.mcpb