Gearcoleco MCP Server

Gearcoleco MCP Server

drheliusGPL-3.0
133 звёзд22 форков
Gearcoleco — эмулятор игровой приставки ColecoVision с открытым исходным кодом. Написан на C++. Работает на Windows, macOS, Linux и BSD. Главная особенность — встроенный MCP-сервер. Через него AI-ассистент управляет отладкой: читает регистры Z80, ставит точки останова, просматривает видеопамять. Разработчикам ретро-игр и энтузиастам не нужен сторонний отладчик. Всё управление — текстовыми запросами к ассистенту в чате.
Открыть на GitHub

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

Общее

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

Технологии

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

Описание

Возможности

  • Загрузка и запуск ROM-образов картриджей ColecoVision
  • Чтение текущего состояния регистров процессора Z80
  • Дамп оперативной и видеопамяти TMS9918
  • Установка и удаление точек останова по адресу в коде
  • Пошаговое исполнение инструкций с автоматическим выводом состояния
  • Управление эмуляцией: пауза, возобновление, сброс консоли
  • Сохранение снимков состояния эмуляции в файл

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

Установите Gearcoleco. Скачайте готовую сборку для вашей платформы со страницы релизов на GitHub. Либо соберите из исходников.

Пропишите бинарник в настройках MCP-клиента. Пример конфигурации для Claude Desktop:

{ "mcpServers": { "gearcoleco": { "command": "/путь/к/gearcoleco", "args": ["--mcp"] } } }

Перезапустите клиент. Сервер готов к работе.

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

  • Покажи текущее состояние регистров Z80 и объясни, что делает код
  • Поставь точку останова по адресу 0x1234 и продолжай эмуляцию
  • Загрузи ROM-файл из папки Games и запусти эмуляцию
  • Сделай дамп видеопамяти и опиши, что на экране
  • Объясни, какой участок кода исполняется прямо сейчас

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

  • Язык: C++
  • Транспорт: stdio
  • Лицензия: GPL-3.0
  • Платформы: Windows, macOS, Linux, BSD
  • Совместимость: Claude Desktop, любой MCP-клиент с stdio

Поделиться