Geargrafx MCP Server

Geargrafx MCP Server

drheliusGPL-3.0
215 звёзд13 форков
Geargrafx — это точный эмулятор ПК-Еngine, TurboGrafx-16, SuperGrafx и PCE CD-ROM². Он написан на C++ и работает на Windows, macOS, Linux, BSD и RetroArch. В эмулятор встроен MCP-сервер (Model Context Protocol). Это значит, что вы можете отлаживать и анализировать ретро-игры прямо из AI-ассистента. Вместо отдельного GUI отладчика — обычный текстовый чат. Через MCP-сервер AI-агент управляет эмулятором: ставит точки останова, ищет значения в памяти, патчит байты и загружает ROM-образы. Такой подход удобен для реверс-инжиниринга, поиска секретов, создания спидран-подсказок и модов к играм.
Открыть на GitHub

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

Общее

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

Технологии

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

Описание

Возможности

MCP-сервер открывает отладчик Geargrafx для AI-ассистента. Через него доступны все ключевые функции отладки эмулятора:

  • Чтение и запись оперативной памяти (RAM) и видеопамяти (VRAM) в реальном времени.
  • Получение значений всех регистров процессора HuC6280.
  • Установка и снятие точек останова на выполнение кода по любому адресу.
  • Управление эмуляцией: запуск, пауза, пошаговое выполнение инструкций (trace), сброс состояния.
  • Загрузка образов картриджей, дисков и компакт-дисков (CD-ROM²) текстовыми командами через чат.
  • Мониторинг состояния графического и звукового процессоров.
  • Создание полного дампа памяти в заданном диапазоне адресов.
  • Изменение значений в памяти на лету (Live patching) без перезапуска эмуляции.
  • Переключение режимов видео (NTSC / PAL) и управление слотами контроллеров.
  • Просмотр и редактирование стека вызовов.

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

Сервер не требует отдельной установки. MCP-сервер встроен прямо в исполняемый файл эмулятора.

  1. Скачайте последнюю версию Geargrafx со страницы релизов на GitHub.
  2. Пропишите путь к скачанному файлу в конфигурации вашего MCP-клиента. Пример для Claude Desktop:
{ "mcpServers": { "geargrafx": { "command": "/полный/путь/к/Geargrafx" } } }

На Windows путь к файлу выглядит так: "command": "C:\\Путь\\к\\Geargrafx.exe".

  1. Перезапустите MCP-клиент, чтобы он загрузил новый сервер.

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

  • «Найди в памяти игры значения, отвечающие за количество жизней. Покажи адреса и текущие значения. Затем запиши в них значение 99.»
  • «Поставь точку останова на адрес $C000 и расскажи, какие инструкции там выполняются. Выполни пошагово 10 инструкций.»
  • «Приостанови эмуляцию, покажи состояние всех регистров процессора и дамп стека. Проанализируй, почему игра зависла.»
  • «Загрузи ROM-файл "Bonk's Adventure.pce" и запусти эмуляцию. Когда игра запустится, сделай скриншот состояния видеопамяти.»
  • «Сбрось эмуляцию. Загрузи образ CD-ROM² "Rondo of Blood". Переключи видео на режим NTSC.»

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

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

Поделиться