Gearsystem MCP Server

Gearsystem MCP Server

drheliusGPL-3.0
370 звёзд60 форков
Gearsystem — эмулятор Sega Master System, Game Gear и SG-1000 с точностью на уровне тактов. Он написан на C++, работает на Windows, macOS, Linux, BSD и RetroArch. Внутрь эмулятора встроен MCP-сервер, который открывает AI-ассистенту прямой доступ к отладчику. Через чат вы управляете эмуляцией, читаете и записываете память, ставите точки останова. Это автоматизирует реверс-инжиниринг, тестирование ROM и поиск пасхалок. Вам не нужно переключаться между окнами — вся отладка проходит внутри разговора с ассистентом.
Gaming
Открыть на GitHub

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

Общее

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

Технологии

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

Описание

Возможности

  • Загружать любые ROM-файлы для Master System, Game Gear и SG-1000 в форматах .sms, .gg, .sg
  • Запускать, приостанавливать и останавливать эмуляцию, управлять скоростью
  • Читать и записывать данные в оперативную память эмулятора в реальном времени — например, количество жизней
  • Устанавливать и снимать точки останова на выполнение кода, чтение или запись памяти
  • Получать полные дампы регистров процессора Z80 для анализа
  • Делать снимки экрана и сохранять их на диск
  • Сохранять и загружать состояния (save states) для быстрого переключения между сценами
  • Трассировать выполнение инструкций процессора для глубокого анализа логики игры
  • Работать с несколькими экземплярами эмуляции одновременно

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

MCP-сервер встроен в эмулятор. Отдельная установка пакетов не требуется.

  1. Скачайте Gearsystem с GitHub под вашу операционную систему
  2. Установите и запустите эмулятор
  3. Добавьте конфигурацию в ваш MCP-клиент (Claude Desktop, VS Code):
    { "mcpServers": { "gearsystem": { "command": "/путь/к/Gearsystem", "args": ["--mcp"], "transport": "stdio" } } }
  4. Перезапустите клиент. Сервер появится в списке доступных инструментов.

Замените путь в параметре command на актуальный для вашей системы.

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

  • «Загрузи ROM Sonic the Hedgehog для Master System и поставь точку останова на адресе 0x100»
  • «Приостанови эмуляцию и покажи текущие значения регистров Z80»
  • «Сделай снимок экрана и сохрани его на рабочем столе»
  • «Найди в памяти значение 0x64 и замени его на 0x63»
  • «Загрузи состояние сохранения из файла quicksave.svs»
  • «Покажи трассу последних 50 выполненных инструкций»

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

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

Поделиться