ghidraMCP

ghidraMCP 是一个模型上下文协议服务器，用于让大型语言模型自主地对应用程序进行逆向工程。它为 MCP 客户端提供了来自 Ghidra 核心功能的众多工具。

https://github.com/user-attachments/assets/36080514-f227-44bd-af84-78e29ee1d7f9

功能

MCP 服务器 + Ghidra 插件

• 在 Ghidra 中反编译和分析二进制文件
• 自动重命名方法和数据
• 列出方法、类、导入和导出

安装

先决条件

• 安装 Ghidra
• Python3
• MCP SDK

Ghidra

首先，从本仓库下载最新的 release。其中包含了 Ghidra 插件和 Python MCP 客户端。然后，您可以直接将插件导入到 Ghidra 中。

1. 运行 Ghidra
2. 选择 File -> Install Extensions
3. 点击 + 按钮
4. 从下载的 release 中选择 GhidraMCP-1-2.zip（或您选择的版本）
5. 重启 Ghidra
6. 确保在 File -> Configure -> Developer 中启用了 GhidraMCPPlugin
7. 可选: 在 Ghidra 中通过 Edit -> Tool Options -> GhidraMCP HTTP Server 配置端口

视频安装指南：

https://github.com/user-attachments/assets/75f0c176-6da1-48dc-ad96-c182eb4648c3

MCP 客户端

理论上，任何 MCP 客户端都应能与 ghidraMCP 配合使用。下面给出三个示例。

示例 1: Claude Desktop

要将 Claude Desktop 设置为 Ghidra 的 MCP 客户端，请前往 Claude -> Settings -> Developer -> Edit Config -> claude_desktop_config.json，并添加以下内容：

{
  "mcpServers": {
    "ghidra": {
      "command": "python",
      "args": [
        "/ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py",
        "--ghidra-server",
        "http://127.0.0.1:8080/"
      ]
    }
  }
}

或者，直接编辑此文件：

/Users/YOUR_USER/Library/Application Support/Claude/claude_desktop_config.json

服务器 IP 和端口是可配置的，应设置为指向目标 Ghidra 实例。如果未设置，则两者都将默认为 localhost:8080。

示例 2: Cline

要将 GhidraMCP 与 Cline 一起使用，还需要手动运行 MCP 服务器。首先运行以下命令：

python bridge_mcp_ghidra.py --transport sse --mcp-host 127.0.0.1 --mcp-port 8081 --ghidra-server http://127.0.0.1:8080/

唯一必需的参数是传输方式。如果其他参数未指定，则它们将默认为上述值。一旦 MCP 服务器运行起来，打开 Cline 并在顶部选择 MCP Servers。

然后选择 Remote Servers，并添加以下内容，确保 URL 与 MCP 主机和端口匹配：

1. 服务器名称：GhidraMCP
2. 服务器 URL：http://127.0.0.1:8081/sse

示例 3: 5ire

另一个支持后端多种模型的 MCP 客户端是 5ire。要设置 GhidraMCP，请打开 5ire 并前往 Tools -> New，设置以下配置：

1. 工具键：ghidra
2. 名称：GhidraMCP
3. 命令：python /ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py

从源代码构建

1. 将以下文件从您的 Ghidra 目录复制到本项目的 lib/ 目录中：

• Ghidra/Features/Base/lib/Base.jar
• Ghidra/Features/Decompiler/lib/Decompiler.jar
• Ghidra/Framework/Docking/lib/Docking.jar
• Ghidra/Framework/Generic/lib/Generic.jar
• Ghidra/Framework/Project/lib/Project.jar
• Ghidra/Framework/SoftwareModeling/lib/SoftwareModeling.jar
• Ghidra/Framework/Utility/lib/Utility.jar
• Ghidra/Framework/Gui/lib/Gui.jar

2. 使用 Maven 构建，运行：

mvn clean package assembly:single

生成的 zip 文件包含构建好的 Ghidra 插件及其资源。这些文件是 Ghidra 识别新扩展所必需的。

• lib/GhidraMCP.jar
• extensions.properties
• Module.manifest

GhidraMCP 快速上手指南

GhidraMCP 是一个基于模型上下文协议（MCP）的服务器工具，旨在让大语言模型（LLM）能够自主调用 Ghidra 的核心功能进行二进制逆向工程。它支持反编译、自动重命名、列出方法/类/导入导出表等操作。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Windows, macOS 或 Linux
• 核心软件：已安装 Ghidra (建议最新稳定版)
• 运行环境：Python 3.x
• 依赖库：MCP Python SDK

  pip install mcp
  

• 构建工具（仅源码编译需要）：Maven

提示：国内用户若下载 Ghidra 或 Python 包较慢，可配置国内镜像源（如清华源、阿里源）加速 pip 安装。

安装步骤

1. 安装 Ghidra 插件

1. 从 GitHub Releases 页面下载最新版本的 GhidraMCP-x-x.zip 文件。
2. 启动 Ghidra。
3. 点击菜单栏 File -> Install Extensions。
4. 点击绿色的 + 按钮，选择刚才下载的 zip 文件。
5. 重启 Ghidra。
6. 验证启用：进入 File -> Configure -> Developer，确保 GhidraMCPPlugin 处于勾选状态。
7. （可选）配置端口：如需修改默认服务端口，进入 Edit -> Tool Options -> GhidraMCP HTTP Server 进行设置（默认为 8080）。

2. 配置 MCP 客户端

根据您的使用场景，选择以下任一客户端进行配置。

方案 A：Claude Desktop (推荐)

编辑配置文件 claude_desktop_config.json：

• macOS 路径: /Users/YOUR_USER/Library/Application Support/Claude/claude_desktop_config.json
• Windows 路径: %APPDATA%\Claude\claude_desktop_config.json

添加以下配置（请将 /ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py 替换为实际绝对路径）：

{
  "mcpServers": {
    "ghidra": {
      "command": "python",
      "args": [
        "/ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py",
        "--ghidra-server",
        "http://127.0.0.1:8080/"
      ]
    }
  }
}

方案 B：Cline (VS Code 插件)

1. 在终端手动启动 MCP 桥接服务：

   python bridge_mcp_ghidra.py --transport sse --mcp-host 127.0.0.1 --mcp-port 8081 --ghidra-server http://127.0.0.1:8080/
   

2. 打开 VS Code 中的 Cline 插件，点击顶部的 MCP Servers。
3. 选择 Remote Servers 并添加新服务：
   • Server Name: GhidraMCP
   • Server URL: http://127.0.0.1:8081/sse

方案 C：5ire

1. 打开 5ire，进入 Tools -> New。
2. 填写以下配置：
   • Tool Key: ghidra
   • Name: GhidraMCP
   • Command: python /ABSOLUTE_PATH_TO/bridge_mcp_ghidra.py (替换为实际路径)

基本使用

完成上述配置后，即可开始使用：

1. 启动 Ghidra 并加载一个二进制文件项目。
2. 确保后台服务运行：如果您使用的是 Cline 或手动模式，请确保 bridge_mcp_ghidra.py 脚本正在运行且无报错。
3. 在 LLM 客户端中交互：
   • 在 Claude Desktop 或 Cline 对话框中，直接发送自然语言指令。
   • 示例指令：
     • "反编译当前的 main 函数并解释其逻辑。"
     • "列出项目中所有的导出函数。"
     • "根据功能分析，自动重命名这个子程序。"

AI 将自动通过 MCP 协议调用 Ghidra 接口执行操作，并将结果返回给您。