Repolode
radareorg

radareorg/radare2-mcp

AI 에이전트가 CLI, r2 플러그인 또는 HTTP를 통해 radare2로 바이너리를 분석할 수 있게 해주는 MCP 서버입니다.

스타
355
포크
43
열린 이슈
9
마지막 커밋
22일 전

어떤 프로젝트인가요?

r2mcp는 C로 작성된 Model Context Protocol(MCP) 서버로, Claude, VS Code Copilot Chat, Zed, OpenCode 같은 AI 에이전트를 오픈소스 리버스 엔지니어링 프레임워크인 radare2에 연결합니다. 에이전트는 구조화된 도구를 통해 바이너리를 열고 분석을 실행하거나 r2 명령을 내릴 수 있으며, 모델은 이를 바탕으로 함수, 문자열, 디스어셈블리 코드를 직접 살펴볼 수 있습니다.

서버는 데스크톱 MCP 클라이언트를 위해 stdin/stdout으로 실행하거나, 선택적으로 bearer token 인증을 지원하고 X-Session-ID 헤더로 세션별 멀티플렉싱을 제공하는 HTTP MCP 서버로 실행할 수 있습니다. 이미 실행 중인 radare2 세션 안에서 플러그인으로 실행하면 로드된 파일과 분석 상태를 그대로 재사용합니다. r2pipe를 통해 로컬 또는 원격 r2 및 iaito 세션에 연결할 수도 있습니다.

접근 제어 옵션으로는 읽기 전용 모드, 샌드박스 잠금, 도구 선택 제한 또는 세부 설정, 위험한 run 도구에 대한 승인 모드가 있습니다. 선택 사항인 r2xsql 플러그인을 추가하면 분석 데이터를 조회하는 SQL 도구를 사용할 수 있습니다.

핵심 기능

  • 01radare2 API를 기반으로 C로 구현했습니다.
  • 02stdin/stdout, HTTP MCP 서버 또는 r2 core 플러그인으로 실행할 수 있습니다.
  • 03r2pipe를 통해 로컬 또는 원격 r2 및 iaito 세션에 연결합니다.
  • 04읽기 전용 모드, 샌드박스 잠금, 세부적인 도구 제한을 제공합니다.
  • 05선택적 bearer token 인증과 세션별 HTTP 멀티플렉싱을 지원합니다.
  • 06선택적으로 r2 명령이나 r2js 스크립트를 직접 실행할 수 있습니다.

활용 사례

  • Claude Desktop이나 VS Code의 AI 어시스턴트로 바이너리를 1차 분석하고 함수를 요약합니다.
  • 대상 파일을 읽기 전용으로 유지하면서 에이전트의 리버스 엔지니어링 단계를 자동화합니다.
  • 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 클라이언트에서 실행하도록 만들어졌으며, 셸에서 직접 실행하는 용도가 아닙니다.

포함된 컬렉션

토픽

자주 묻는 질문

radare2-mcp은(는) 무엇인가요?
AI 에이전트가 CLI, r2 플러그인 또는 HTTP를 통해 radare2로 바이너리를 분석할 수 있게 해주는 MCP 서버입니다. r2mcp는 C로 작성된 Model Context Protocol(MCP) 서버로, 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 어시스턴트로 바이너리를 1차 분석하고 함수를 요약합니다. 대상 파일을 읽기 전용으로 유지하면서 에이전트의 리버스 엔지니어링 단계를 자동화합니다. 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

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트