
Gearboy MCP Server
drheliusGPL-3.0
1.2k звёзд170 форков
Gearboy MCP Server — это интерфейс для отладки и управления эмулятором Gearboy через стандартный протокол MCP. Эмулятор работает с играми для Nintendo Game Boy, Game Boy Color и Super Game Boy.
Сервер встроен прямо в эмулятор. Вы можете подключать к нему ИИ-ассистентов (Claude, Cline, Continue) и отдавать команды на естественном языке: читать память, ставить брейкпоинты, делать скриншоты, перематывать эмуляцию. Gearboy MCP Server подходит разработчикам ретро-игр, исследователям и энтузиастам, которые хотят автоматизировать отладку через ИИ.
- Сервер сообщества
- Локальный запуск (stdio)
- C++
- Лицензия GPL-3.0
- Обновлён 21 ноября 2026 г.
Как подключить Gearboy MCP Server
- Откройте репозиторий или документацию проекта и найдите команду запуска сервера (обычно npx, uvx или docker).
- Добавьте сервер в конфигурацию клиента: имя, команду запуска и переменные окружения с ключами, если они нужны.
- Перезапустите клиент и проверьте, что в списке инструментов появился Gearboy MCP Server.
Где лежит файл конфигурации у Claude Desktop, Cursor, VS Code и других клиентов, показано в начале каталога MCP.
Характеристики
Общее
- СтатусСообщество
- Разработчикdrhelius
- ЛицензияGPL-3.0
- Последний релиз21.11.2026
- Активность источника21.11.2026
Технологии
- ЯзыкиC++
- Транспортstdio — локальный запуск
Описание
Возможности
- Читать и записывать память эмулятора (RAM, VRAM, HRAM)
- Устанавливать и снимать брейкпоинты на выполнение кода
- Ставить паузу, возобновлять и изменять скорость эмуляции
- Создавать и загружать состояния сохранения (save states)
- Делать скриншоты текущего экрана игры
- Получать информацию о регистрах процессора LR35902
- Следить за текущим состоянием эмуляции в реальном времени
- Управлять загрузкой ROM-файлов без перезапуска эмулятора
- Получать подробный дамп стека и дизассемблированный код
Как подключить
- Установите Gearboy. Скачайте готовую сборку для вашей системы с GitHub или соберите из исходного кода.
- Запустите эмулятор в режиме MCP-сервера. Gearboy встраивает MCP-сервер прямо в бинарник. Для подключения укажите в конфигурации MCP-хоста команду запуска эмулятора:
{ "mcpServers": { "gearboy": { "command": "/путь/к/Gearboy", "args": ["--mcp"] } } } - Перезапустите 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





