# Ghidra Headless MCP

> 仅以无界面方式运行的 MCP 服务器，通过 PyGhidra 驱动 Ghidra，设计为与智能体运行在同一容器中，而不是连接 Ghidra 图形界面。其 34 组共 212 个工具涵盖程序与项目生命周期、反汇编、反编译与 P-code、补丁与内存修改、符号、引用、类型与结构布局、搜索和图提取，其他需求可通过直接执行 Python、调用 Java API 或运行脚本完成。程序默认以只读方式打开，修改在支持撤销与重做的事务中进行；伪后端让开发和 CI 无需安装 Ghidra 即可运行，ghidra_cli 客户端则把同一套工具提供给不使用 MCP 的命令行和智能体。

- 类型：集成
- 目标：二进制
- 类别：独立 MCP 集成
- 关联：独立智能体集成
- 来源复核于：2026-10-20
- 收录于：2026-11-02
- 原始资源：<https://github.com/mrphrazer/ghidra-headless-mcp>
- 一手来源：<https://github.com/mrphrazer/ghidra-headless-mcp/blob/307b461cdbbedfbafb3771333f21875b745f940e/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/ghidra-headless-mcp/>
- 记录 JSON：<https://awesomerea.org/resources/ghidra-headless-mcp/record.json>
- 英文版：[English](https://awesomerea.org/resources/ghidra-headless-mcp/index.md)

## 使用条件与局限

- 所审阅的 main 提交（2026-09-16）标为 0.1.0 版，没有标签或发行版；更新日志把所有改动都列在 Unreleased 下，RELEASING.md 称源码发行版只发布到 GitHub、不发布到 PyPI，并要求在选定许可证之前不要创建公开发行标签。需从检出的源码用 pip 安装。README 称代码、测试和文档全部是“vibe coding”写成的。
- 需要 Python 3.11+、pyghidra 3.0.2+，以及通过 GHIDRA_INSTALL_DIR 或 --ghidra-install-dir 指定的本地 Ghidra 安装；README 未注明最低 Ghidra 版本。MCP 可经 stdio 或 TCP 运行，README 给出了 Claude Code、Codex 和通用 MCP 主机的配置示例，以及一个在智能体旁安装 Ghidra 的 Kali 基础 Dockerfile 示例。调试器、Version Tracking、FID、BSim 和模拟器相关工作流被列为尚未提供。
- ghidra.eval、ghidra.call 和 ghidra.script 会在 Ghidra 运行时中执行任意 Python、Java 代码和脚本，两种传输方式均无身份验证；TCP 服务器只绑定 127.0.0.1，README 要求仅在受信任的容器化环境中使用。只读会话可保护程序状态，但不会隔离文件系统或进程访问。
- 仓库在 samples/ 中附带一个已剥离符号的 AArch64 GNU coreutils ls 可执行文件，作为功能模糊测试器的默认目标，另有一个小型已编译的 hello 测试样本及其 C 源码。README 称 CI 还会运行真实 Ghidra 测试和 wheel 检查，但所审阅的工作流只运行 Ruff 和基于伪后端的非真实环境 pytest 测试。
- GitHub 依据初始提交中加入的 LICENSE 文件识别为 GPL-2.0，而 README 和 RELEASING.md 仍视许可证为尚未选定，pyproject.toml 也未声明许可证。

## 一手来源

1. <https://github.com/mrphrazer/ghidra-headless-mcp/blob/307b461cdbbedfbafb3771333f21875b745f940e/README.md>
2. <https://github.com/mrphrazer/ghidra-headless-mcp/blob/307b461cdbbedfbafb3771333f21875b745f940e/FEATURE_SUPPORT.md>
3. <https://github.com/mrphrazer/ghidra-headless-mcp/blob/307b461cdbbedfbafb3771333f21875b745f940e/CHANGELOG.md>
4. <https://github.com/mrphrazer/ghidra-headless-mcp/blob/307b461cdbbedfbafb3771333f21875b745f940e/RELEASING.md>
5. <https://github.com/mrphrazer/ghidra-headless-mcp/blob/307b461cdbbedfbafb3771333f21875b745f940e/pyproject.toml>
6. <https://github.com/mrphrazer/ghidra-headless-mcp/blob/307b461cdbbedfbafb3771333f21875b745f940e/.github/workflows/ci.yml>
7. <https://github.com/mrphrazer/ghidra-headless-mcp/blob/307b461cdbbedfbafb3771333f21875b745f940e/LICENSE>
8. <https://github.com/mrphrazer/ghidra-headless-mcp/blob/307b461cdbbedfbafb3771333f21875b745f940e/ghidra_headless_mcp/_version.py>
9. <https://github.com/mrphrazer/ghidra-headless-mcp/tree/307b461cdbbedfbafb3771333f21875b745f940e/samples>
10. <https://github.com/mrphrazer/ghidra-headless-mcp/tree/307b461cdbbedfbafb3771333f21875b745f940e/tests/fixtures>

## 同分区更多条目：智能体与 MCP

- [Binary Ninja Headless MCP（无界面）](https://awesomerea.org/zh/resources/binary-ninja-headless-mcp/index.md) · 集成
- [IDA-Skill IDA Pro 恶意样本分析智能体技能](https://awesomerea.org/zh/resources/ida-skill-malware-analysis/index.md) · 集成
- [BinAssist Binary Ninja 大模型辅助分析插件](https://awesomerea.org/zh/resources/binassist/index.md) · 集成
- [Reversecore MCP 逆向与安全分析 MCP 服务器](https://awesomerea.org/zh/resources/reversecore-mcp/index.md) · 集成
- [AutoProber 飞针探测自动化套件](https://awesomerea.org/zh/resources/autoprober/index.md) · 集成
- [ToCode 面向智能体的二进制类源码导出工具](https://awesomerea.org/zh/resources/tocode/index.md) · 集成

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。