Geargrafx MCP Server
Встроенный MCP-сервер эмулятора Geargrafx: агент отлаживает игры PC Engine, смотрит память и дизассемблер, ставит точки останова.
- 261 ★ репозитория
- Последний коммит
- GPL-3.0
Расширенный доступ
Почему такой уровень
- Агент управляет выполнением игры и может менять память эмулируемой системы.
- HTTP-сервер по умолчанию слушает только 127.0.0.1.
Установка
- Работает в
Ручная установка
Скачай MCPB-пакет Geargrafx для своей платформы со страницы релизов, установи его в Claude Desktop или запусти эмулятор с флагом `--mcp-stdio` и вызови инструмент состояния CPU.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент управляет выполнением игры и может менять память эмулируемой системы.
- HTTP-сервер по умолчанию слушает только 127.0.0.1.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Geargrafx — точный кроссплатформенный эмулятор TurboGrafx-16, PC Engine, SuperGrafx и их приставок на CD и лазерных дисках, написанный на C++. В него встроен MCP-сервер для отладки и разработки с помощью агентов. Инструменты дают полный доступ к отладчику: регистры процессора, память, точки останова и управление выполнением, а также дизассемблер вокруг счетчика команд или любого адреса, просмотр областей RAM, VRAM, ROM и памяти CD-ROM. Сервер показывает состояние чипов HuC6280, HuC6270, HuC6260, HuC6202, PSG и CD-ROM, перечисляет 64 спрайта с картинками, ведет отладочные символы и закладки, показывает стек вызовов и состояние ввода. Запуск идет флагами `--mcp-stdio` или `--mcp-http`, есть режим без окна `--headless`. Клиенты Claude Code и Codex подключаются через упакованные MCPB-файлы или напрямую.
Для кого. Разработчикам игр под PC Engine и энтузиастам ретро-платформ, которым нужен агент для трассировки кода и разбора железа.
Подходит, если
- Агент ставит точку останова на доступ к памяти и объясняет, кто пишет в нужную ячейку.
- Нужно разобрать дизассемблер подпрограммы и найти, где вызывается рендер спрайтов.
- Спрайты и регистры видео смотрят, чтобы понять причину графического глюка.
- Сервер работает без окна на CI-машине и отдает состояние по HTTP.
Не подходит, если
- Нужны другие платформы: эмулятор покрывает только семейство PC Engine.
- Нет образов игр и BIOS: для CD-ROM нужен System Card.
- Требуется точный аппаратный отладчик на реальной приставке.
Пример запроса к агенту
Поставь точку останова на запись в адрес 0x2200, продолжи выполнение и покажи дизассемблер вокруг места остановки.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Ограничения
Эмулятор запускает образы игр и для CD-ROM требует BIOS, рекомендуется System Card 3.0. Образы и BIOS пользователь берет сам, их в репозитории нет. Поддерживаются форматы `chd`, `cue/bin`, `cue/img`, `cue/iso`, MP3-дорожки не поддерживаются. Для LaserActive нужен японский PAC-N1/PCE-LP1 или американский PAC-N10 BIOS. HTTP-сервер по умолчанию слушает `127.0.0.1:7777`. Проект распространяется по GPL-3.0. Агент с полным доступом к памяти меняет состояние игры.
Как отключить. Удалите MCPB-пакет в настройках клиента или запись geargrafx из MCP-конфигурации. Эмулятор снимается как обычная программа, настройки лежат рядом при режиме `--portable`.
Частые вопросы
Как запустить MCP-сервер Geargrafx?
Запустите эмулятор с флагом `--mcp-stdio` или `--mcp-http`. Для HTTP адрес и порт задают `--mcp-http-address` и `--mcp-http-port`, по умолчанию 127.0.0.1:7777. Режим `--headless` работает без окна.
Что такое пакеты MCPB?
Это пакеты MCP Bundle, которые содержат Geargrafx вместе с конфигурацией MCP для клиентов с установкой пакетов. Они собраны для Windows, macOS и Linux на x64 и ARM64 и опубликованы в реестре MCP.
Есть ли скиллы для агентов?
Да, два: `geargrafx-debugging` для отладки, трассировки и проверки железа и `geargrafx-romhacking` для работы с памятью, переводов и патчей. Они учат агента пользоваться эмулятором.
Какие области памяти доступны?
RAM, VRAM, ROM, RAM CD-ROM, RAM Arcade Card и другие. Инструменты также дают дизассемблер, закладки и отладочные символы.
Работает ли эмулятор в RetroArch?
Да, у проекта есть ядро libretro. Но встроенный MCP-сервер входит в настольные сборки, а описание ядра приведено в документации libretro.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЭмулятор Game Boy с отладчиком и встроенным MCP-сервером: агент управляет выполнением, читает память и разбирает аппаратное состояние
Эмулятор Sega Master System, Game Gear и SG-1000 с MCP-сервером: агент ставит точки останова, читает память и разбирает видеочип
MCP-сервер, который один раз строит граф кода проекта и отдает агенту готовые ответы вместо повторного перечитывания файлов
MCP-сервер для Godot 4 внутри самого редактора: агент правит сцены, узлы и скрипты, запускает проект и читает отладчик, без Node.js
Консольный отладчик MCP-серверов от Giant Swarm: REPL для инструментов, OAuth 2.1 и режим MCP-сервера для Cursor
MCP-сервер для движка Godot: запуск редактора, выполнение проектов и правка сцен прямо из агента
Коротко о README
Эмулятор распространяется для Windows, macOS, Linux, BSD и RetroArch. В отдельном файле MCP_README собраны пакеты, инструменты и настройка клиентов.