逆向工程AI辅助工具

GhidraMCP

Ghidra扩展通过 模型上下文协议（MCP）.在Ghidra中打开二进制文件，启用插件，让Claude（或任何MCP客户端）反编译函数、重命名符号、注释代码、搜索漏洞等。

建筑

 AI Client (Claude Desktop / CLI)
        |  stdio + MCP JSON-RPC
        v
   Go MCP Bridge  (mcp_bridge)
        |  TCP, length-prefixed JSON-RPC
        v
   Ghidra Plugin  (MCPServerPlugin)
        |
        v
   Ghidra Program API

这 Ghidra插件 （Java）在Ghidra中启动TCP服务器并自动启动 去桥 二元的。该网桥通过stdio向AI客户端发送MCP，并通过具有4字节长度前缀JSON-RPC帧的本地TCP套接字将调用转发给Java插件。可选的API-key身份验证可保护TCP通道。

特性

• 70个MCP工具 跨越查询、变异、分析、恶意软件分类、物联网/嵌入式安全、结构管理、异步反编译和多实例支持
• 易于设置 --插件自动启动网桥；使用 MCP>设置>写入Claude配置 配置MCP客户端
• 跨平台 --为Linux x86_64、Windows x86_64macOS x86_64.和macOS ARM64预构建的桥接二进制文件
• 可配置的 --端口，localhost-only绑定，API-key身份验证，自动启动，通过启用/禁用桥接 GhidraMCP.properties
• 多实例 --使用以下命令同时处理多个Ghidra窗口 target_port 路由工具调用
• 异步反编译 --无阻塞地反编译大型函数；稍后对结果进行投票
• 连接重试 --如果Ghidra重新启动或连接中断，网桥会自动重新连接
• 分页 --支持大型结果集（函数、字符串、导入等） offset/limit 用于安全增量检索
• CI/CD --自动构建、Go+Java测试、Ghidra集成测试，以及新Ghidra版本发布时的自动发布

快速开始

先决条件

• 吉德拉 12.0.3+
• Java 21+
• 兼容MCP的AI客户端(克劳德桌面, 克劳德代码等等）

安装

1. 从下载最新版本的ZIP 发布
2. 在Ghidra： 文件>安装扩展>“+”>选择ZIP
3. 重新启动Ghidra

启用

1. 打开一个项目和一个程序（二进制）
2. 文件>配置>GhidraMCP--检查MCPServerPlugin
3. 插件自动启动TCP服务器（默认 localhost:8765)并启动大桥

要配置Claude Desktop，请打开 MCP>设置 然后单击 写信给Claude Config。对于其他MCP客户端，请单击 复制到剪贴板 并将其添加到您的客户端配置中：

{
  "mcpServers": {
    "ghidra": {
      "command": "/path/to/mcp_bridge",
      "args": ["--host", "localhost", "--port", "8765"]
    }
  }
}

如果您有一个API密钥集，请将其包含在 env block（插件会自动执行此操作）：

{
  "mcpServers": {
    "ghidra": {
      "command": "/path/to/mcp_bridge",
      "args": ["--host", "localhost", "--port", "8765"],
      "env": {
        "GHIDRA_API_KEY": "your-key-here"
      }
    }
  }
}

您还可以从Ghidra中获取代码片段： MCP>复制MCP配置 （将其复制到剪贴板）。

工具

参数、类型和示例的完整参考： TOOLS.md

下表给出了快速概述。看 TOOLS.md 查看详细的参数文档。

查询（1-21）

突变（22-38）

高级分析（39-45）

恶意软件分析（46-53）

物联网/嵌入式安全（54-59）

公用事业（60-62）

多实例（63）

所有工具都接受可选 target_port 参数，用于将调用路由到特定的Ghidra实例。这使您可以同时处理在单独的Ghidra窗口中打开的多个二进制文件。

结构管理（64-68）

异步反编译（69-70）

异步反编译对于可能需要30多秒才能反编译的大型函数非常有用。客户端可以启动反编译，继续其他工作，并在以后轮询结果。

配置

该插件将设置存储在 GhidraMCP.properties 在Ghidra的用户设置目录中：

设置对话框

打开 MCP>设置 在Ghidra菜单中，通过GUI配置所有属性。该对话框包括：

• 已启用端口、本地主机绑定、API密钥、自动启动和桥接的可编辑字段
• 生成 按钮，用于创建加密随机32个字符的API密钥
• 写信给Claude Config 将GhidraMCP合并到Claude Desktop的按钮 claude_desktop_config.json
• 复制到剪贴板 按钮，用于复制MCP配置JSON代码段以进行手动设置
• 如果在没有API密钥的情况下启用远程访问，则会发出安全警告
• 保存时，如果服务器正在运行，则会自动重新启动提示

单击“确定”时，更改将保存到磁盘。您还可以直接在对话框中显示的路径上编辑属性文件。

如果 auto_start 是 false，从手动启动服务器 MCP>切换服务器 在Ghidra菜单中。

注： 这 bridge_enabled 该设置适用于高级用例——开发人员调试桥接二进制文件，或者用户使用自定义MCP客户端直接与Java服务器进行TCP通信。大多数用户应该启用它。

安全

默认情况下，TCP服务器绑定到 仅限本地主机 并且已经 没有API密钥，这对于本地单用户使用来说很好。对于更严格的设置：

API-Key身份验证

1. 打开 MCP>设置 然后单击 生成 创建随机密钥（或键入自己的密钥）
2. 单击“确定”保存——网桥在下次启动时自动拾取密钥
3. 在连接时，网桥发送 authenticate 在任何其他呼叫之前使用密钥请求
4. 服务器拒绝所有非身份验证请求，直到身份验证成功
5. 之后 3次失败的尝试 服务器终止连接

API密钥通过 GHIDRA_API_KEY 环境变量（不是CLI标志），以防止它在进程参数列表中泄漏。手动运行网桥时，设置环境变量：

# Linux/macOS
export GHIDRA_API_KEY="your-key-here"
./mcp_bridge --host localhost --port 8765

# Windows (PowerShell)
$env:GHIDRA_API_KEY = "your-key-here"
.\mcp_bridge.exe --host localhost --port 8765

当设置了API密钥时 写信给Claude Config 和 复制到剪贴板 “设置”对话框中的按钮包括 env 自动封锁。

本地主机绑定

随着 localhost_only=true （默认），服务器只接受来自的连接 127.0.0.1。设置为 false 如果你需要远程访问（例如，无头服务器上的Ghidra），但是 始终使用API密钥 在本地主机之外暴露端口时。

远程/无头设置

GhidraMCP可以为运行在不同机器上的AI客户端提供服务。当Ghidra在无头分析服务器上运行，而AI客户端在其他地方运行时，这很有用。

1. 打开 MCP>设置
2. 取消选中 仅限本地主机 接受远程连接
3. 点击 生成 创建API密钥（始终使用一个用于远程访问）
4. 单击“确定”并重新启动服务器

在远程计算机上，配置MCP客户端以指向Ghidra主机：

{
  "mcpServers": {
    "ghidra": {
      "command": "/path/to/mcp_bridge",
      "args": ["--host", "ghidra-server.local", "--port", "8765"],
      "env": {
        "GHIDRA_API_KEY": "your-key-here"
      }
    }
  }
}

警告： 在本地主机之外公开服务器时，请始终使用API密钥。在没有身份验证的情况下，任何可以访问该端口的人都可以完全访问Ghidra API。

从源头构建

git clone https://github.com/13bm/GhidraMCP.git
cd GhidraMCP

建造Go桥

cd mcp-bridge
go build -o mcp_bridge .
cd ..

构建Ghidra扩展

export GHIDRA_INSTALL_DIR=/path/to/ghidra
gradle buildExtension

扩展名ZIP将位于 dist/.

运行测试

# Go tests
cd mcp-bridge && go test ./... -v && cd ..

# Java unit + integration tests (requires Xvfb on headless Linux)
xvfb-run gradle test -PGHIDRA_INSTALL_DIR=$GHIDRA_INSTALL_DIR

CI/CD

该项目使用GitHub Actions进行自动构建和发布：

• build.yml --触发推送/PR master 以及标签上。运行Go测试，交叉编译4个平台的桥，在Xvfb下运行Java单元+Ghidra集成测试，构建扩展ZIP，并在 v* 标签。
• check-ghidra-release.yml --每天跑步。检测新的Ghidra版本，打开版本升级PR，通过GitHub App自动批准，如果所有测试都通过，则自动合并。

贡献

欢迎投稿！请打开问题或提交pull请求。

1. 分叉存储库
2. 创建要素分支： git checkout -b feature/my-feature
3. 提交您的更改
4. 推送并打开拉取请求

许可证

Apache许可证2.0

致谢

• 国家安全局/吉德拉
• 模型上下文协议
• mcp走 --Go MCP SDK

GhidraMCP不隶属于国家安全局或Ghidra项目，也不受其认可。