# Geargrafx MCP Server

Встроенный MCP-сервер эмулятора Geargrafx для PC Engine и TurboGrafx-16. Позволяет ИИ-агенту управлять исполнением игры, читать память и отлаживать код.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 248
- Автор: drhelius
- Лицензия: GPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/drhelius/Geargrafx
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/mcp/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`.

## Установка

### Claude Code (родная платформа)

**Установка**
- Команды запуска нет в реестре MCP — смотрите README репозитория

## Когда брать
- исследовать оперативную память эмулятора PC Engine во время работы игры
- ставить точки останова и управлять пошаговым выполнением инструкций процессора через ИИ
- отслеживать содержимое видеорегистров и фоновых слоёв при отладке homebrew-проектов
- перематывать состояние игры назад для повторного воспроизведения бага

## Примеры запросов агенту
- Проверь состояние видеорегистров VDC и скажи, почему не отрисовался фон
- Останови эмуляцию на следующем кадре и выгрузи дамп памяти по адресу $2000
- Перемотай исполнение на десять шагов назад и проверь флаги процессора

## Похожие
- [Pascal 3D Editor](https://affpapa.org/nevibecode/mcp/pascal-3d-editor.md) — MCP-сервер · ★ 25085
- [Unity-MCP](https://affpapa.org/nevibecode/mcp/unity-mcp.md) — MCP-сервер · ★ 4523
- [mcp](https://affpapa.org/nevibecode/mcp/sceneview-mcp.md) — MCP-сервер · ★ 1348
- [Gearboy MCP Server](https://affpapa.org/nevibecode/mcp/gearboy-mcp-server.md) — MCP-сервер · ★ 1219
- [ChiR24-unreal_mcp_server](https://affpapa.org/nevibecode/mcp/chir24-unreal-mcp-server.md) — MCP-сервер · ★ 975
- [Nova3D](https://affpapa.org/nevibecode/mcp/nova3d.md) — MCP-сервер · ★ 733

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md