Repolode
radareorg

radareorg/radare2-mcp

让 AI 智能体通过 MCP 协议调用 radare2 进行二进制分析的服务端,可用于命令行、r2 插件或 HTTP 模式。

Star
355
Fork
43
未关闭 Issue
9
最近提交
23天前

这是什么?

r2mcp 是用 C 语言编写的 MCP(Model Context Protocol)服务端,将 Claude、VS Code Copilot Chat、Zed、OpenCode 等 AI 智能体连接到开源逆向工程框架 radare2。智能体可以通过结构化工具打开二进制文件、执行分析并发出 r2 命令,自行查看函数、字符串和反汇编结果。

服务端支持三种运行方式:通过标准输入输出供桌面 MCP 客户端使用;以 HTTP MCP 服务运行,可选 Bearer Token 认证,并通过 X-Session-ID 请求头实现多会话隔离;或作为 radare2 核心插件运行在已打开的会话中,直接复用当前已加载的文件和分析状态。也可以通过 r2pipe 连接本地或远程的 r2、iaito 会话。

访问控制可灵活配置,包括只读模式、沙箱锁定、工具白名单与精细化工具配置,并提供对危险执行类工具的审批机制。安装配套的 r2xsql 插件后,还可以通过 SQL 工具查询分析数据。

核心功能

  • 01基于 radare2 原生 API 使用 C 语言实现。
  • 02支持标准输入输出、HTTP MCP 服务和 r2 核心插件三种运行方式。
  • 03通过 r2pipe 连接本地或远程的 r2 与 iaito 会话。
  • 04提供只读模式、沙箱锁定和细粒度的工具限制。
  • 05支持 Bearer Token 认证和基于 X-Session-ID 的多会话 HTTP 服务。
  • 06可选择开放原始 r2 命令与 r2js 脚本的执行能力。

适用场景

  • 在 Claude Desktop 或 VS Code 中让 AI 助手初步分析二进制文件并总结函数功能。
  • 让智能体自动执行逆向工程步骤,同时以只读模式保护目标文件。
  • 通过 HTTP 将共享的 radare2 分析服务提供给多个客户端使用。
  • 借助 r2xsql 插件用 SQL 查询分析结果。

快速上手

  1. 1

    通过 r2pm 安装 r2mcp

    r2pm -Uci r2mcp
  2. 2

    在客户端配置中添加 MCP 服务器条目(命令 r2pm,参数 -r r2mcp)

  3. 3

    或者,构建 Docker 镜像

    docker build -t r2mcp .

使用前须知

  • 需要安装 radare2,较新的 HTTP 会话和认证功能要求 radare2 ABI 91 或更高版本。
  • r2mcp 二进制文件应由 MCP 客户端启动,而不是直接在 shell 中运行。

收录于专题

标签

常见问题

radare2-mcp 是什么?
让 AI 智能体通过 MCP 协议调用 radare2 进行二进制分析的服务端,可用于命令行、r2 插件或 HTTP 模式。 r2mcp 是用 C 语言编写的 MCP(Model Context Protocol)服务端,将 Claude、VS Code Copilot Chat、Zed、OpenCode 等 AI 智能体连接到开源逆向工程框架 radare2。智能体可以通过结构化工具打开二进制文件、执行分析并发出 r2 命令,自行查看函数、字符串和反汇编结果。
radare2-mcp 可以免费使用吗?用的什么许可证?
radare2-mcp 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
radare2-mcp 还在维护吗?
活跃维护中。radare2-mcp 最近一次提交是在 2026年10月15日。
radare2-mcp 适合用来做什么?
在 Claude Desktop 或 VS Code 中让 AI 助手初步分析二进制文件并总结函数功能。 让智能体自动执行逆向工程步骤,同时以只读模式保护目标文件。 通过 HTTP 将共享的 radare2 分析服务提供给多个客户端使用。 借助 r2xsql 插件用 SQL 查询分析结果。
radare2-mcp 怎么安装和运行?
通过 r2pm 安装 r2mcp: r2pm -Uci r2mcp 在客户端配置中添加 MCP 服务器条目(命令 r2pm,参数 -r r2mcp) 或者,构建 Docker 镜像: docker build -t r2mcp .
在哪里获取 radare2-mcp?
源代码和安装说明在 GitHub 上:https://github.com/radareorg/radare2-mcp

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目