
Gearsystem MCP Server
drheliusGPL-3.0
400 звёзд65 форков
Gearsystem — эмулятор Sega Master System, Game Gear и SG-1000 с точностью на уровне тактов. Он написан на C++, работает на Windows, macOS, Linux, BSD и RetroArch. Внутрь эмулятора встроен MCP-сервер, который открывает AI-ассистенту прямой доступ к отладчику.
Через чат вы управляете эмуляцией, читаете и записываете память, ставите точки останова. Это автоматизирует реверс-инжиниринг, тестирование ROM и поиск пасхалок. Вам не нужно переключаться между окнами — вся отладка проходит внутри разговора с ассистентом.
- Сервер сообщества
- Локальный запуск (stdio)
- C++
- Лицензия GPL-3.0
- Обновлён 21 ноября 2026 г.
Как подключить Gearsystem MCP Server
- Откройте репозиторий или документацию проекта и найдите команду запуска сервера (обычно npx, uvx или docker).
- Добавьте сервер в конфигурацию клиента: имя, команду запуска и переменные окружения с ключами, если они нужны.
- Перезапустите клиент и проверьте, что в списке инструментов появился Gearsystem MCP Server.
Где лежит файл конфигурации у Claude Desktop, Cursor, VS Code и других клиентов, показано в начале каталога MCP.
Характеристики
Общее
- СтатусСообщество
- Разработчикdrhelius
- ЛицензияGPL-3.0
- Последний релиз21.11.2026
- Активность источника21.11.2026
Технологии
- ЯзыкиC++
- Транспортstdio — локальный запуск
Описание
Возможности
- Загружать любые ROM-файлы для Master System, Game Gear и SG-1000 в форматах .sms, .gg, .sg
- Запускать, приостанавливать и останавливать эмуляцию, управлять скоростью
- Читать и записывать данные в оперативную память эмулятора в реальном времени — например, количество жизней
- Устанавливать и снимать точки останова на выполнение кода, чтение или запись памяти
- Получать полные дампы регистров процессора Z80 для анализа
- Делать снимки экрана и сохранять их на диск
- Сохранять и загружать состояния (save states) для быстрого переключения между сценами
- Трассировать выполнение инструкций процессора для глубокого анализа логики игры
- Работать с несколькими экземплярами эмуляции одновременно
Как подключить
MCP-сервер встроен в эмулятор. Отдельная установка пакетов не требуется.
- Скачайте Gearsystem с GitHub под вашу операционную систему
- Установите и запустите эмулятор
- Добавьте конфигурацию в ваш MCP-клиент (Claude Desktop, VS Code):
{ "mcpServers": { "gearsystem": { "command": "/путь/к/Gearsystem", "args": ["--mcp"], "transport": "stdio" } } } - Перезапустите клиент. Сервер появится в списке доступных инструментов.
Замените путь в параметре 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)





