Geargrafx MCP Server — MCP-сервер для Claude Code: что делает
Встроенный MCP-сервер эмулятора Geargrafx для PC Engine и TurboGrafx-16. Позволяет ИИ-агенту управлять исполнением игры, читать память и отлаживать код.
Открыть на GitHubЧто делает Geargrafx MCP Server
Geargrafx — это кроссплатформенный эмулятор консолей PC Engine, TurboGrafx-16 и SuperGrafx, написанный на C++. В него встроен сервер протокола MCP. Он даёт языковым моделям прямой доступ к процессу эмуляции: агент может останавливать выполнение, шагать по инструкциям и изучать состояние оборудования.
Сервер открывает инструменты для проверки значений в оперативной памяти, чтения видеорегистров, контроля спрайтов и перемотки кадров назад. Это убирает рутину при поиске багов в ретро-играх и тестировании собственного кода для HuCard или CD-ROM².
Для запуска в Linux в системе должна стоять библиотека libsdl3, а на Windows могут потребоваться Visual C++ Redistributable и OpenGL Compatibility Pack. Эмулятор распространяется в виде готовых сборок или ставится на macOS через brew install --cask drhelius/geardome/geargrafx.
Какие задачи решает
- исследовать оперативную память эмулятора PC Engine во время работы игры
- ставить точки останова и управлять пошаговым выполнением инструкций процессора через ИИ
- отслеживать содержимое видеорегистров и фоновых слоёв при отладке homebrew-проектов
- перематывать состояние игры назад для повторного воспроизведения бага
Примеры запросов агенту
- Проверь состояние видеорегистров VDC и скажи, почему не отрисовался фон
- Останови эмуляцию на следующем кадре и выгрузи дамп памяти по адресу $2000
- Перемотай исполнение на десять шагов назад и проверь флаги процессора
Как установить Geargrafx MCP Server
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Geargrafx MCP Server
Как установить Geargrafx MCP Server в Claude Code?
Сервер встроен непосредственно в эмулятор Geargrafx. Достаточно скачать готовый бинарник для своей системы из релизов проекта или установить приложение на macOS командой brew install --cask drhelius/geardome/geargrafx, после чего подключить его к Claude Code через протокол MCP.
Какие консоли поддерживает эмулятор Geargrafx?
Он эмулирует системы TurboGrafx-16, PC Engine, SuperGrafx, а также форматы CD-ROM², Super CD-ROM², Arcade CD-ROM² и LaserActive LD-ROM².
Какие системные библиотеки нужны для работы?
В среде Linux может потребоваться пакет libsdl3. На Windows нужны установленные Visual C++ Redistributable и пакет совместимости OpenGL.
