C64 Bridge MCP сервер

AI командный мост для аппаратного обеспечения Commodore 64, который управляет устройствами Ultimate 64 и C64 Ultimate через REST API с программированием на BASIC и ассемблере, инспекцией памяти, аудиосинтезом SID и базой знаний ретрокомпьютинга.

Установка

NPX

npx -y c64bridge@latest

NPM (локально в проекте)

mkdir -p ~/c64bridge && cd ~/c64bridge
npm init -y
npm install c64bridge
node ./node_modules/c64bridge/dist/index.js

Из исходного кода

git clone https://github.com/chrisgleissner/c64bridge.git
cd c64bridge
npm install
npm start

Конфигурация

VS Code Copilot Chat

{
  "github.copilot.chat.experimental.mcp": {
    "servers": [
      {
        "name": "c64bridge",
        "command": "node",
        "args": ["./node_modules/c64bridge/dist/index.js"],
        "type": "stdio"
      }
    ]
  }
}

Конфигурация аппаратного обеспечения (C64U)

{
  "c64u": { "host": "<hostname or IP>", "port": 80 }
}

Конфигурация VICE

{
  "vice": { "exe": "/usr/bin/x64sc" }
}

Доступные инструменты

Инструмент	Описание
`c64_config`	Чтение/запись конфигурации, диагностика и снимки
`c64_disk`	Монтирование дисков, листинги, создание образов и поиск программ
`c64_drive`	Питание привода, режимы, сброс и операции с ROM
`c64_extract`	Извлечение спрайтов/наборов символов, дампы памяти, статистика файловой системы и проверки работоспособности прошивки
`c64_graphics`	PETSCII арт, превью спрайтов и генерация битмапов
`c64_memory`	Ввод/вывод памяти, чтение экрана и мониторинг экрана
`c64_printer`	Помощники печати для принтеров Commodore и Epson
`c64_program`	Загрузка программ, выполнение и пакетные рабочие процессы
`c64_rag`	BASIC и ассемблерные RAG-запросы из базы знаний
`c64_sound`	Управление SID, плейбук, композиция и рабочие процессы анализа
`c64_stream`	Запуск и остановка сессий Ultimate потокового вещания
`c64_system`	Питание, сброс, меню и управление фоновыми задачами

Возможности

Исполнители программ для BASIC, ассемблера 6510 и PRG/CRT
Полный доступ к памяти — операции чтения/записи и текстовый мониторинг
Системная интеграция, покрывающая приводы, файлы и принтеры
Инструменты SID аудио для композиции, воспроизведения и анализа
Встроенная база знаний для более умных AI-запросов с использованием локальных примеров и документации
Несколько бэкендов: аппаратный C64 Ultimate (основной) и экспериментальный VICE

Переменные окружения

Опциональные

C64BRIDGE_CONFIG - Абсолютный путь к файлу конфигурации
C64_MODE - Принудительный выбор бэкенда (c64u|vice)
LOG_LEVEL - Установка уровня логирования (например, debug)

Примеры использования

Напечатать приветствие на экране

Сочинить детскую песню с ChatGPT + VS Code

Создать PETSCII арт для песен

Ресурсы

GitHub Repository

Примечания

Поддерживает как stdio (для локальной AI интеграции), так и HTTP (для удаленного доступа). Требует Node.js 24+ и npm. Сервер проверяет вашу цель (REST + чтение нулевой страницы) и выводит диагностику перед объявлением о запуске на stdio. Конфигурация определяется из переменной окружения C64BRIDGE_CONFIG, ~/.c64bridge.json или ./c64bridge.json в указанном порядке.