Gearboy MCP Server

Gearboy MCP Server

drheliusGPL-3.0
1.1k звёзд154 форков
Gearboy MCP Server — это интерфейс для отладки и управления эмулятором Gearboy через стандартный протокол MCP. Эмулятор работает с играми для Nintendo Game Boy, Game Boy Color и Super Game Boy. Сервер встроен прямо в эмулятор. Вы можете подключать к нему ИИ-ассистентов (Claude, Cline, Continue) и отдавать команды на естественном языке: читать память, ставить брейкпоинты, делать скриншоты, перематывать эмуляцию. Gearboy MCP Server подходит разработчикам ретро-игр, исследователям и энтузиастам, которые хотят автоматизировать отладку через ИИ.
Gaming
Открыть на GitHub

Характеристики

Общее

  • СтатусСообщество
  • Разработчикdrhelius
  • ЛицензияGPL-3.0

Технологии

  • Языки
    C++
  • Транспорт
    stdio

Описание

Возможности

  • Читать и записывать память эмулятора (RAM, VRAM, HRAM)
  • Устанавливать и снимать брейкпоинты на выполнение кода
  • Ставить паузу, возобновлять и изменять скорость эмуляции
  • Создавать и загружать состояния сохранения (save states)
  • Делать скриншоты текущего экрана игры
  • Получать информацию о регистрах процессора LR35902
  • Следить за текущим состоянием эмуляции в реальном времени
  • Управлять загрузкой ROM-файлов без перезапуска эмулятора
  • Получать подробный дамп стека и дизассемблированный код

Как подключить

  1. Установите Gearboy. Скачайте готовую сборку для вашей системы с GitHub или соберите из исходного кода.
  2. Запустите эмулятор в режиме MCP-сервера. Gearboy встраивает MCP-сервер прямо в бинарник. Для подключения укажите в конфигурации MCP-хоста команду запуска эмулятора: { "mcpServers": { "gearboy": { "command": "/путь/к/Gearboy", "args": ["--mcp"] } } }
  3. Перезапустите MCP-клиент. Если всё настроено верно, ассистент сможет управлять эмулятором.

Примеры запросов

  • «Покажи содержимое регистра AF процессора в данный момент»
  • «Поставь брейкпоинт на адрес 0x4040 и сделай скриншот, когда он сработает»
  • «Прочитай 16 байт из VRAM, начиная с адреса 0x8000, и объясни, что там записано»
  • «Создай состояние сохранения в слоте 3 и возобнови эмуляцию на скорости 200 %»
  • «Найди в памяти игры значение 0x64 и замени его на 0x00»

Технические детали

  • Язык разработки: C++ (основной код эмулятора и сервера)
  • Транспорт: stdio
  • Лицензия: GPL-3.0
  • Совместимые клиенты: Claude Desktop, Cline, Continue, Zed и любые другие MCP-клиенты с поддержкой stdio
  • Платформы: Windows, macOS, Linux, BSD, RetroArch

Поделиться