Gearsystem MCP
Эмулятор Sega Master System, Game Gear и SG-1000 с MCP-сервером: агент ставит точки останова, читает память и разбирает видеочип
- 400 ★ репозитория
- Последний коммит
- GPL-3.0
Широкий доступ
Почему такой уровень
- Клиент запускает локальный исполняемый файл эмулятора, а агент пишет в память консоли, загружает ROM и сохранения по указанным путям и пишет видео и журналы на диск
- В HTTP-режиме на нелокальном адресе управление эмулятором открывается по сети, поэтому сервер требует токен
Установка
- Работает в
Ручная установка
brew install --cask drhelius/geardome/gearsystemДля macOS. Если Homebrew просит доверять стороннему tap, выполните brew trust --tap drhelius/geardome. На других системах скачайте сборку из релизов.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Клиент запускает локальный исполняемый файл эмулятора, а агент пишет в память консоли, загружает ROM и сохранения по указанным путям и пишет видео и журналы на диск
- В HTTP-режиме на нелокальном адресе управление эмулятором открывается по сети, поэтому сервер требует токен
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Gearsystem — эмулятор консолей Sega Master System, Game Gear и SG-1000 на C++ с графическим отладчиком. MCP-сервер встроен в сам эмулятор и работает рядом с его окном: агент и человек видят одно состояние, а правки через MCP сразу появляются в интерфейсе. Агент получает набор отладчика целиком: пауза и пошаговое выполнение Z80, регистры, чтение и запись разных областей памяти, дизассемблирование, точки останова на выполнение, чтение и запись, стек вызовов, символы, закладки и наблюдения. Отдельные инструменты показывают видеопроцессор VDP, звуковые чипы PSG и YM2413 и все 64 спрайта. Еще агент делает снимок экрана, пишет видео в AVI и нажимает кнопки контроллеров. В набор входят трассировка событий процессора, VDP, ввода, звука и маппера, профайлер функций с числом вызовов и тактами, перемотка и слоты сохранений. Поиск по памяти запоминает снимок, сравнивает его после действия в игре и находит переменные вроде жизней или счета. В репозитории лежат два скилла для агентов: один про отладку и трассировку, другой про переводы, читы и ROM-хаки.
Для кого. Для разработчиков игр под Sega Master System, Game Gear и SG-1000 и для тех, кто изучает или переделывает старые ROM: переводы, читы, разбор алгоритмов.
Подходит, если
- Игра рисует искаженную графику, и нужно разобрать регистры VDP, содержимое VRAM и таблицу атрибутов спрайтов
- Нужно найти обработчик прерывания VBlank и подписать символами подпрограммы, которые он вызывает
- Нужно найти в памяти переменную жизней или счета и собрать чит через поиск со снимками
- Надо узнать, какие функции игры съедают больше всего тактов за кадр, и профайлер даст цифры
- Для описания ошибки нужны снимок экрана или AVI-запись нескольких сотен кадров
Не подходит, если
- Нужен эмулятор другой консоли: Gearsystem знает только Master System, Game Gear и SG-1000
- С одним экземпляром эмулятора должны работать сразу несколько агентов: они делят общее состояние и мешают друг другу
- Нельзя запускать на машине нативный исполняемый файл: сервер — это сам эмулятор, который клиент стартует локально
Пример запроса к агенту
Загрузи ROM `/path/to/game.sms`, найди обработчик прерывания VBlank, подпиши символами подпрограммы, которые он вызывает, и объясни, что он делаетMCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
GEARSYSTEM_MCP_HTTP_TOKENсекрет- Токен для авторизации в HTTP-режиме. Обязателен при привязке не к локальному адресу, иначе сервер не стартует.
Ограничения
MCP-сервер входит в приложение, отдельного пакета для npm или PyPI нет. Эмулятор ставят командой `brew install --cask drhelius/geardome/gearsystem` на macOS, из PPA или RPM на Linux либо скачивают сборку из релизов. Для Claude Desktop есть готовые расширения MCPB под Windows, macOS и Linux на x64 и ARM64. На Windows могут понадобиться Visual C++ Redistributable и OpenGL Compatibility Pack.
Пока работает MCP-сервер, эмулятор не встает на паузу при потере фокуса окна, даже если включена настройка `Pause When Inactive`. Снимки экрана в режиме без окна берут параметры из меню `Debug`, их задают заранее в графическом интерфейсе. Нужен собственный ROM-файл. Снимки и результаты отладки возвращаются MCP-клиенту и могут попасть в контекст его модели. Лицензия GPL-3.0.
Как отключить. Уберите запись `gearsystem` из конфигурации клиента: в Claude Code выполните `claude mcp remove gearsystem`, в VS Code удалите блок из `.vscode/mcp.json`, в Claude Desktop удалите расширение в разделе `Extensions` настроек или запись в `claude_desktop_config.json`. Папки скиллов `gearsystem-debugging` и `gearsystem-romhacking` удалите из каталога скиллов агента. Сам эмулятор можно оставить как обычное приложение.
Частые вопросы
Как подключить Gearsystem к Claude Code?
Выполните `claude mcp add --transport stdio gearsystem -- /path/to/gearsystem --mcp-stdio` с путем к исполняемому файлу и проверьте `claude mcp list`. MCP-клиент запускает эмулятор по этой конфигурации, а свой ROM загрузите инструментом `load_media`.
Чем режим `stdio` отличается от `HTTP` в Gearsystem?
В режиме `stdio` клиент сам запускает эмулятор и общается с ним через каналы ввода и вывода, документация рекомендует этот режим. В режиме HTTP эмулятор запускают вручную командой `gearsystem --mcp-http`, он слушает `127.0.0.1:7777/mcp`, а клиент подключается к уже работающему процессу. Порт меняет флаг `--mcp-http-port`.
Как уменьшить число инструментов Gearsystem в контексте агента?
Запустите эмулятор с флагом `--mcp-router`. Тогда напрямую остаются 12 частых инструментов, среди них `load_media`, `read_memory`, `set_breakpoint` и `get_screenshot`, а остальные вызываются через `search_tools`, `get_tool_info` и `execute_tool`.
Можно ли запустить отладку Gearsystem без окна?
Да, флаг `--headless` используется вместе с `--mcp-stdio` или `--mcp-http`. Для независимых HTTP-сеансов назначьте каждому процессу свой порт. Если используете `--portable`, нужны отдельные копии приложения в разных каталогах: настройки сохраняются рядом с исполняемым файлом.
Как найти адрес переменной жизней в игре на Master System?
Сделайте снимок командой `memory_search_capture`, потеряйте жизнь в игре и запустите `memory_search` с оператором сравнения, например меньше предыдущего значения. Повторяйте сравнение, чтобы сузить список адресов-кандидатов. Этот цикл описан в скилле `gearsystem-romhacking`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЭмулятор Game Boy с отладчиком и встроенным MCP-сервером: агент управляет выполнением, читает память и разбирает аппаратное состояние
Встроенный MCP-сервер эмулятора Geargrafx: агент отлаживает игры PC Engine, смотрит память и дизассемблер, ставит точки останова.
Локальный граф кода и контекст для агентов: сущности, связи Git и записанные ошибки отдаются через консоль, хуки и MCP
Пакет summer-engine соединяет агента с игровым движком Summer: MCP-сервер, скиллы по геймдеву и CLI для сборки и публикации игр.
Context Engine — поиск по коду и память для агента
Context Engine
Скилл учит агента сначала обращаться к индексу кода и графу символов Context Engine и только потом читать файлы напрямую
Universal Modder
universal-modder
Плагин и скиллы для модов к играм на вашем ПК: разведка движка, разбор кода, ассеты через fal, проверка в запущенной игре и ролик с результатом
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Gearsystem (эта карточка) | нет | не нужна | 400 | |
| Gearboy | да | не нужна | 1 221 | эмулятор Game Boy того же автора с таким же MCP-отладчиком |
| GhidrAssistMCP | нет | не нужна | 810 | статический разбор бинарников в Ghidra: псевдокод и графы вызовов без запуска игры |
Коротко о README
Релиз 3.9.24 содержит пакеты MCPB для Windows, macOS и Linux на x64 и ARM64. Документация основной ветки обновляется отдельно от релизов, поэтому наличие новой команды сверяйте с установленной сборкой. Скиллы отладки и ROM-хакинга дополняют эмулятор инструкциями.