본문으로 건너뛰기
ReviewRamble

주간 브리프

AI 리뷰를 받은편지함으로.

  • 도구, 모델, MCP 서버, 저장소의 새 리뷰(결론부터)
  • 변경이 있을 때 다시 확인한 가격과 평점
  • 새로 발행된 분석 글

모델, 에이전트, MCP 서버, 그리고 정말 시간을 들일 만한 도구.

일주일에 한 통입니다. 각 브리프의 링크로 구독을 해지할 수 있습니다. 이메일 사용 방식

Gearboy

MCP 서버를 내장한 게임보이·게임보이 컬러 에뮬레이터입니다. 브레이크포인트, 메모리, 디스어셈블리, 되감기용 디버거 도구 76개를 제공합니다.

리뷰어: ReviewRamble editors · 업데이트

설치 문서 오픈 소스

이 페이지 공유:XLinkedInFacebookRedditWhatsApp이메일

평점

4.2/5

성숙하고 정확한 에뮬레이터로, MCP 서버가 에이전트에게 완전한 디버거를 넘겨 줍니다. 네트워크 기본값은 신중하고, 실행 중인 게임에 대한 쓰기 권한은 모두 줍니다.

Gearboy의 개요

Gearboy는 개발자 drhelius가 만든 게임보이, 게임보이 컬러, 슈퍼 게임보이용 오픈소스 에뮬레이터로, C++로 작성되었고 저장소는 2012년부터 있었습니다. 디버거도 새로 만든 2026년 3월의 3.8.0 버전부터 에뮬레이터 안에 MCP 서버를 내장합니다. Claude Code나 Codex 같은 에이전트는 게임을 일시 정지하고, SM83 명령을 하나씩 실행하고, 메모리를 읽고 쓰고, 브레이크포인트를 걸고, LCD와 오디오 하드웨어를 살피고, 화면을 캡처하고, 컨트롤러를 조작할 수 있으며, 그동안 디버거 GUI에도 같은 상태가 표시됩니다.

저장소의 스타는 약 1,220개이고 라이선스는 GPL-3.0이며, 2026년 11월 15일에 3.8.21을 출시했고 같은 주에도 커밋이 있었습니다. 데스크톱 빌드는 Windows, macOS, Linux, BSD를 지원합니다. 6가지 플랫폼·아키텍처 조합용 MCP Bundles(.mcpb)가 MCP Registry에 게시되어 있고, 두 개의 Agent Skills가 디버깅과 ROM 해킹을 다룹니다.

Gearboy 설치 방법

claude mcp add --transport stdio --scope user gearboy -- /path/to/gearboy --mcp-stdio

Gearboy, 쓸 만한 가치가 있습니까?

이 MCP 서버는 얇은 껍데기가 아니라 실제 디버거로 들어가는 입구입니다. MCP README에는 12개 그룹에 걸쳐 76개 도구가 나와 있습니다. 명령 하나, 프레임 하나 단위까지의 실행 제어, CPU 레지스터, ROM 뱅크·VRAM·WRAM·OAM·IO 읽기와 쓰기, 치트 검색기 방식의 메모리 검색, 심볼과 북마크가 붙은 디스어셈블리, 호출 스택, 트레이스 로거, 사이클 수를 보여 주는 함수별 프로파일러, 되감기 버퍼 탐색, 세이브 스테이트, 치트, 컨트롤러 매크로가 있습니다. RGBDS, GBDK-2020, WLA-DX 등 툴체인의 심볼 파일은 ROM 옆에 있으면 자동으로 불러오며, 이것이 디스어셈블리를 모델이 읽을 수 있게 만듭니다.

목록이 이렇게 길면 세션마다 컨텍스트를 소모하는데, --mcp-router 플래그가 이를 해결합니다. 자주 쓰는 12개 도구는 직접 노출하고 나머지는 search_tools, get_tool_info 같은 탐색 도구 5개로 찾습니다. Claude Code처럼 도구 스키마를 나중에 불러오는 클라이언트가 있기 때문에 기본값은 모든 도구를 직접 노출합니다.

네트워크 노출 기본값은 신중합니다. 권장 전송 방식은 stdio이며 포트를 열지 않습니다. --mcp-http 또는 MCP 메뉴로 시작하는 HTTP 모드는 127.0.0.1:7777/mcp에서 대기합니다. 이 주소에서는 토큰 없이도 동작하지만, 와일드카드나 루프백이 아닌 주소에는 GEARBOY_MCP_HTTP_TOKEN을 Bearer 토큰으로 반드시 요구하며 없으면 서버가 시작을 거부합니다. DNS 리바인딩을 막기 위해 Host와 Origin 헤더를 실제 목적지 주소와 대조합니다. 알아 둘 한계가 두 가지 있습니다. 모든 HTTP 클라이언트가 같은 에뮬레이터 인스턴스를 제어하므로 동시에 움직이는 에이전트가 서로의 일시 정지, 브레이크포인트, 메모리 쓰기를 되돌릴 수 있습니다. README는 에이전트마다 별도 포트에서 headless 인스턴스를 하나씩 띄우라고 권합니다. 또 여러 도구가 디스크를 다룹니다. load_media와 load_state_file은 프로세스가 접근할 수 있는 모든 경로를 읽고, save_state_file, start_video_recording, 트레이스 로거는 파일을 씁니다. 트레이스 로거는 최대 1 GB까지, 요청하면 무제한으로 씁니다.

주요 경쟁 상대는 ROM을 정적으로 읽는 Ghidra용 서버 같은 범용 리버스 엔지니어링 서버입니다. Gearboy는 ROM을 실제로 실행하며 정적 도구로는 보이지 않는 하드웨어 상태를 보여 줍니다. 외부 에뮬레이터를 통해 코모도어 64에서 비슷한 작업을 하는 c64bridge와 비교하면, 한 메인테이너가 에뮬레이터와 서버를 모두 맡는다는 장점이 있습니다. 이 1인 체제는 장기적인 위험이기도 하지만, 출시 주기(10월 24일 이후 세 번)와 열린 이슈 3건은 관리가 잘 되고 있음을 보여 줍니다.

제 역할을 하는 곳

  • GBDK-2020으로 만든 게임을 출시하는 홈브루 개발자

    부하가 큰 스테이지에서 프레임을 떨어뜨리는 루틴 찾기

    심볼 파일과 함께 ROM을 불러오고, 에이전트에게 몇 초간 프로파일러를 돌려 함수를 프레임당 사이클 순으로 정렬하게 한 뒤 가장 무거운 함수를 단계별로 실행합니다. 무료이며 수작업으로 브레이크포인트를 거는 저녁 시간을 대신합니다.

  • 일본 게임보이 컬러 RPG를 작업하는 팬 번역자

    텍스트 테이블과 대사를 출력하는 루틴 찾기

    에이전트에게 알려진 문자열을 메모리에서 검색하고, 찾은 곳에 읽기 브레이크포인트를 걸고, 호출 스택을 따라 출력 루틴까지 거슬러 올라가며 심볼을 추가하게 합니다. gearboy-romhacking 스킬이 이 흐름을 설명합니다.

  • 레트로 컴퓨터 구조 과목을 가르치는 강사

    한 프레임 동안 CPU와 LCD가 하는 일을 학생에게 보여 주기

    GUI를 연 채로 Gearboy를 실행하고 에이전트가 프레임을 넘기며 LCD 레지스터, 인터럽트, 스프라이트 테이블을 설명하게 합니다. 에이전트가 바꾼 내용은 디버거 창에도 동시에 나타납니다.

도입 전 확인할 점

설정
데스크톱 빌드를 내려받거나 brew install --cask drhelius/geardome/gearboy를 실행한 뒤 claude mcp add --transport stdio --scope user gearboy -- /path/to/gearboy --mcp-stdio로 등록합니다(codex mcp add도 같은 방식입니다). 세션이 시작되면 클라이언트가 에뮬레이터를 실행합니다.
연동
12개 그룹의 도구 76개, 탐색 도구 5개를 갖춘 선택형 라우터 모드, 화면 없는 머신용 headless 모드, MCP Registry의 MCPB 번들, npx skills add drhelius/gearboy로 설치하는 Agent Skills 2개를 제공합니다.
데이터와 개인정보
로컬에서 실행되며 게임 메모리, 스크린숏, 디스어셈블리는 모델 제공업체로 전송됩니다. 계정이나 네트워크 서비스는 없습니다. HTTP 모드는 기본적으로 127.0.0.1:7777에서 대기하며, 루프백 밖에 바인딩하려면 GEARBOY_MCP_HTTP_TOKEN이 필요합니다. 도구는 어떤 경로에서든 ROM과 스테이트 파일을 읽고, 세이브 스테이트, AVI 녹화, 트레이스 로그를 디스크에 쓸 수 있습니다.
대규모 사용 시 비용
GPL-3.0으로 무료입니다. 비용은 모델 사용료뿐이며 긴 트레이스 로그와 잦은 스크린숏으로 늘어납니다.
제한
동시에 접속한 HTTP 클라이언트는 한 인스턴스에서 서로 간섭합니다. --mcp-router 없이는 전체 도구 목록이 큽니다. 트레이스 로그는 1 GB에 이를 수 있고 무제한으로 설정하면 더 커집니다. Windows에서는 Visual C++ Redistributable과 OpenGL Compatibility Pack이 필요할 수 있습니다.

좋은 점

  • 디버거, 프로파일러, 되감기를 아우르는 도구 76개
  • 기본은 stdio, HTTP는 루프백에 바인딩
  • 루프백 밖의 HTTP는 토큰 없이 시작되지 않음
  • 빌드된 패키지, Homebrew cask, MCPB 번들 제공

아쉬운 점

  • 모든 HTTP 클라이언트가 인스턴스 하나를 공유
  • 파일 도구가 접근 가능한 모든 경로를 읽고 씀
  • 게임보이 계열만 지원
  • 커밋 거의 전부를 개발자 한 명이 작성

추천 대상

실행 중인 게임의 추적, 프로파일링, 패치를 에이전트에게 맡기고 싶은 게임보이 홈브루 개발자, ROM 해커, 번역자에게 맞습니다.

Gearboy 대안

Gearboy: 자주 묻는 질문

Gearboy, 쓸 만한 가치가 있습니까?
성숙하고 정확한 에뮬레이터로, MCP 서버가 에이전트에게 완전한 디버거를 넘겨 줍니다. 네트워크 기본값은 신중하고, 실행 중인 게임에 대한 쓰기 권한은 모두 줍니다. 평점은 5점 만점에 4.2점입니다.
Gearboy의 가격은 얼마입니까?
무료 오픈소스(GPL-3.0)입니다. 개발 비용은 GitHub Sponsors로 충당합니다.
Gearboy의 단점은 무엇입니까?
모든 HTTP 클라이언트가 인스턴스 하나를 공유; 파일 도구가 접근 가능한 모든 경로를 읽고 씀; 게임보이 계열만 지원; 커밋 거의 전부를 개발자 한 명이 작성.
Gearboy에 적합한 사람은 누구입니까?
실행 중인 게임의 추적, 프로파일링, 패치를 에이전트에게 맡기고 싶은 게임보이 홈브루 개발자, ROM 해커, 번역자에게 맞습니다.
팀이나 프로덕션 환경에서 Gearboy의 비용은 얼마입니까?
GPL-3.0으로 무료입니다. 비용은 모델 사용료뿐이며 긴 트레이스 로그와 잦은 스크린숏으로 늘어납니다.
Gearboy에 회사 데이터를 맡겨도 안전합니까?
로컬에서 실행되며 게임 메모리, 스크린숏, 디스어셈블리는 모델 제공업체로 전송됩니다. 계정이나 네트워크 서비스는 없습니다. HTTP 모드는 기본적으로 127.0.0.1:7777에서 대기하며, 루프백 밖에 바인딩하려면 GEARBOY_MCP_HTTP_TOKEN이 필요합니다. 도구는 어떤 경로에서든 ROM과 스테이트 파일을 읽고, 세이브 스테이트, AVI 녹화, 트레이스 로그를 디스크에 쓸 수 있습니다.
Gearboy의 가장 좋은 대안은 무엇입니까?
저희가 리뷰한 것 중 가장 가까운 대안은 C64 Bridge, GhidraMCP 및 x64dbg-MCP Server입니다.

답변 확인일: 2026년 11월 16일.

Gearboy 개발사입니까? 이 평점을 사이트에 표시하십시오ReviewRamble 평점: Gearboy, 5점 만점에 4.2점