REA: 프로그램 내부 구조를 조사하는 에이전트용 CLI·MCP 서버
AI 에이전트에 프로그램 내부 구조를 조사하는 도구를 연결하는 CLI·MCP 서버예요. 네이티브 바이너리와 JavaScript·Electron, .NET, 웹사이트 등을 분석하고 근거와 불확실성을 돌려줍니다. 소스코드를 완벽히 복원하거나 기능을 자동 복제해 주는 보증은 아니에요.
주요 기능
에이전트와 터미널에서 같은 분석 흐름
Codex·Claude Code 등의 에이전트가 MCP로 조사하고, 사람이 CLI로도 같은 워크플로를 사용할 수 있어요. 결과의 증거를 보고 추가 질문·설명·구현으로 이어가는 구조예요.
대상별로 분석 방법 선택
네이티브 파일의 의사코드·어셈블리·문자열·참조는 Hopper/Ghidra/IDA/Kuna 같은 엔진을 이용해요. JavaScript·Electron은 모듈·import·소스맵·IPC 관계, .NET은 메타데이터·CIL을 조사해요. 모든 기능에 같은 엔진이 필요한 것은 아니에요.
게임 패키지 조사에도 제한적으로 활용
Godot PCK 형식 2·3·4의 목록·원래 헤더/디렉터리 정보·선택한 내용 식별을 읽는 정적 분석 경로가 있어요. 자체 ZombieBase 배포 파일의 구성 조사 후보로 볼 수 있지만, 게임 플레이·멀티플레이·FPS 시험을 대신하지 않습니다.
구조
에이전트 → MCP 서버 / CLI → 대상별 분석 워크플로 → 내장 정적 판독기 또는 외부 분석 엔진 → 근거가 붙은 결과 순서예요. 로컬 분석이라는 설명과 외부 AI에 결과를 전달하는 단계는 별개예요. 기존 OpenClaw·Codex 총괄 시스템을 대체하기보다 전문 조사 도구로 추가하는 성격이에요.
누구에게 쓸모 있나요
- 자신이 만들었거나 조사 권한이 있는 프로그램의 구조·호환성을 확인하려는 개발자, 유지보수 담당자에게 적합해요.
- 대표님에게는 자체 앱/런처 배포 파일과 Godot PCK를 점검하는 보조 도구 후보예요. 일반 UI 제작·게임 기능 개발은 기존 소스코드 기반 Codex 작업이 우선이에요.
설치 전 준비
- 확인한 package.json 소스 버전은 6.8.0예요. npm 최신 배포판과 이 main 커밋이 항상 같다고 보지는 않습니다.
- Node.js 조건: ^22.23.4 또는 ^24.22.1 또는 >=26.12.1. 지원 범위를 만족하는 Node.js와 npm을 준비해요. 단순히 Node 22가 설치되어 있다는 것만으로 충분하지 않습니다.
- 분석 대상을 소유하거나 필요한 권한을 확보하고, 원본을 보존한 복사본과 별도 작업 폴더를 준비해요.
- 네이티브 분석은 선택 엔진과 그 엔진의 OS·라이선스·런타임 조건이 추가돼요. Linux의 일부 워크플로는 procps 호환 ps가 PATH에 있어야 해요.
- Windows·macOS·Linux: 기능별 지원과 외부 엔진 조건이 다름
- JavaScript 정적 분석: 별도 네이티브 역컴파일 엔진 불필요
- 네이티브: Hopper/Ghidra/IDA/Kuna 중 해당 환경 지원 엔진
- 웹 관찰: Chrome 계열 브라우저 등 별도 조건
설치 방법
1. 공식 경로와 버전 확인
morluto/rea, rea.tools 및 공식 rea-agents npm 패키지에서 출처를 확인해요. 대상 프로젝트 내부가 아닌 신뢰할 수 있는 별도 폴더에서 시작하는 것을 공식 문서가 안내해요.
2. 에이전트 연결 설정
명령은 안내용이며 실행하지 않았어요. 선택한 에이전트와 변경할 파일 경로·MCP·워크플로 설치 계획을 읽고 승인해요. npm 다운로드 승인과 REA 설정 승인은 별개예요. Hopper 설치는 추가 선택이며 자동 필수가 아니에요.
npx rea-agents setup3. 재시작과 대상별 준비 확인
완료 안내에 나온 에이전트를 재시작해요. 기존 설정 백업을 보존하고 분석 엔진 경로를 확인해요. 모든 도구에 권한을 일괄 허용하기보다 필요한 조사 범위부터 시작해요.
선택: CLI를 자주 사용할 때
전역 설치는 선택 사항이에요. 설치·업데이트·연결 설정 변경은 이 자료실 등록 작업에서 수행하지 않았어요.
npm install --global rea-agents
rea --help사용 방법
에이전트에게 조사 범위를 제한해 요청
예: “내가 만든 앱의 복사본에서 모듈과 구성 파일 관계를 정적으로 조사해 주세요. 실행·네트워크 연결·원본 수정 없이, 확인 근거와 모르는 부분을 구분해 주세요.” 문서·분석 도구가 제안하는 추가 실행은 별도로 검토해요.
JavaScript/Electron 정적 분석 예시
본인이 분석할 권한이 있는 디렉터리 또는 ASAR 경로로 바꾸는 공식 CLI 예시예요. 일반 Windows EXE를 이 명령 하나로 모두 분석할 수 있다는 뜻은 아니에요.
npx rea-agents analyze-javascript-application "D:/apps/my-app-copy" --json결과를 실제 제품 검사와 구분
파일·함수·참조 등 결과의 근거를 확인한 뒤 가설을 세웁니다. 자체 게임은 원본 소스·기존 테스트·실제 플레이 검증과 함께 판단하고, 추정된 내부 동작을 확인된 사실로 기록하지 않습니다.
비용과 API 키
REA 저장소 코드는 MIT이며 이 자료 확인에서 REA 자체의 필수 유료 구독은 확인하지 못했어요. 연결할 AI 에이전트의 구독/API 비용, Hopper·IDA 등 선택 도구의 사용 조건과 비용은 별도예요. 기존 AI 구독만으로 모든 외부 엔진을 무료 사용할 수 있다는 뜻은 아니에요. 요금 결제나 API 키 생성은 하지 않았어요.
라이선스
루트 LICENSE는 MIT (2026 morluto)예요. 저작권·허가 고지 유지 조건과 보증 부재가 있어요. 외부 분석 엔진·제3자 구성요소 및 분석 대상 소프트웨어의 권리는 각각 별도이며, REA의 MIT가 대상 코드·에셋의 복제·배포 권리를 부여하지 않습니다.
주의사항과 알려진 이슈
- 공식 SECURITY.md는 REA가 샌드박스가 아니라고 명시해요. 같은 OS 사용자 권한의 악성 프로세스로부터 보호하지 않으며, 신뢰할 수 없는 파일을 열면 외부 분석 엔진에 해석을 맡기게 돼요.
- 정적 조사와 실행·디버거 연결·네트워크 캡처·기기 조작은 권한과 영향이 달라요. 파일 읽기 허용을 계정 조작이나 실행 허용으로 확대하면 안 돼요.
- 공식 사용 지침은 적법한 분석을 전제로 하며 DRM·라이선스·안티치트 회피, 무단 접근, 독점 코드/에셋 복제를 지원하지 않습니다. 대상 라이선스와 약관을 먼저 확인해야 해요.
- 로컬 동작도 데이터 외부 전송 없음의 보증은 아니에요. 에이전트 입력에 코드·트래픽·개인정보가 포함될 수 있으므로 토큰·계정 정보·사유 바이너리를 공개 이슈나 보고서에 넣지 않습니다.
- 역컴파일·추론 결과는 불완전하거나 틀릴 수 있어요. 기능 동작·보안·호환성·원본 소스의 정확한 복원을 보증하지 않습니다.
- 버전 변화가 빠릅니다. 이번 소스는 6.8.0이며 설치할 배포판의 문서와 실제 환경을 다시 대조해야 해요. 대표님 Windows 환경에서 설치·연결·분석 성공은 아직 시험하지 않았어요.
확인 범위
확인 날짜: 2026-10-30
확인 커밋: 8f920bb65b8d8ae669411501b0a3a59a62883ac3
확인한 범위: 2026-10-30 21:32 KST에 공식 main 커밋, README, package.json, 설치 문서, MIT LICENSE, SECURITY, DISCLAIMER, Setup 및 MCP 서버·Godot PCK 판독 코드 일부를 정적으로 확인했어요. 기존 11개 분석 내용은 보존했어요.
확인 한계: REA 패키지·설치 스크립트·분석 엔진을 설치하거나 실행하지 않았어요. 실제 앱/바이너리 분석, API 호출, 로그인, 결제, 에이전트 설정 변경, 성능·보안 검증은 하지 않았어요. 전체 코드 감사나 모든 공개 이슈 검토가 아니며, 소스 버전과 npm 최신 릴리스 일치는 별도 확인하지 않았어요.