C64 Bridge — MCP-сервер для Claude Code: управление Commodore 64
MCP-сервер, через который ИИ-клиент запускает программы, читает память и рисует графику на Commodore 64 — на железе или в эмуляторе VICE.
claude mcp add --env LOG_LEVEL=<LOG_LEVEL> --env C64BRIDGE_CONFIG=<C64BRIDGE_CONFIG> --env C64_MODE=<C64_MODE> --env C64U_HOST=<C64U_HOST> --env C64U_PORT=<C64U_PORT> --transport stdio c64-bridge -- npx -y c64bridgeЧто делает C64 Bridge
C64 Bridge связывает ИИ-клиент с Commodore 64: агент вызывает сгруппированные инструменты вроде c64_program, c64_memory, c64_graphics и c64_sound и так запускает BASIC, ассемблер 6510, образы PRG и CRT, правит память, выводит картинку и звук. Работает с железом семейства C64 Ultimate, Ultimate 64 и U2, а также с эмулятором VICE. Переключение между бэкендами идёт на лету через c64_select_backend, поэтому одна сессия может охватить и реальную машину, и эмуляцию.
Сервер собран на официальном TypeScript SDK @modelcontextprotocol/sdk и умеет stdio для локальной работы; есть и необязательный HTTP-мост для ручной проверки. Кроме инструментов в нём есть ресурсы и промпты.
Перед запуском нужен Node.js 24+ и npm, а бэкенд задаётся переменными окружения: C64_MODE, C64U_HOST, C64U_PORT, путь к бинарю VICE. Без правильно прописанного хоста или бинаря соединение не поднимется. Ставьте, если хотите гонять сборки и эксперименты на C64 прямо из чата с агентом.
Какие задачи решает
- Запустить BASIC-программу на Commodore 64 из чата с агентом
- Прочитать и переписать область памяти на железе или в VICE
- Собрать картинку и вывести её на экран C64
- Проиграть звук через SID в эмуляторе
- Переключить сессию с реальной машины на VICE без перезапуска
Примеры запросов агенту
- Запусти эту PRG-программу на C64 Ultimate и покажи экран
- Прочитай память по адресу и выведи дамп
- Собери картинку в
c64_graphicsи выведи её на экран
Как установить C64 Bridge
Командой платформы
claude mcp add --env LOG_LEVEL=<LOG_LEVEL> --env C64BRIDGE_CONFIG=<C64BRIDGE_CONFIG> --env C64_MODE=<C64_MODE> --env C64U_HOST=<C64U_HOST> --env C64U_PORT=<C64U_PORT> --transport stdio c64-bridge -- npx -y c64bridgeВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Командой платформы
codex mcp add c64-bridge --env LOG_LEVEL=<LOG_LEVEL> --env C64BRIDGE_CONFIG=<C64BRIDGE_CONFIG> --env C64_MODE=<C64_MODE> --env C64U_HOST=<C64U_HOST> --env C64U_PORT=<C64U_PORT> -- npx -y c64bridgeВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"c64-bridge": {
"command": "npx",
"args": [
"-y",
"c64bridge"
],
"env": {
"LOG_LEVEL": "<LOG_LEVEL>",
"C64BRIDGE_CONFIG": "<C64BRIDGE_CONFIG>",
"C64_MODE": "<C64_MODE>",
"C64U_HOST": "<C64U_HOST>",
"C64U_PORT": "<C64U_PORT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"c64-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"c64bridge"
],
"env": {
"LOG_LEVEL": "<LOG_LEVEL>",
"C64BRIDGE_CONFIG": "<C64BRIDGE_CONFIG>",
"C64_MODE": "<C64_MODE>",
"C64U_HOST": "<C64U_HOST>",
"C64U_PORT": "<C64U_PORT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e LOG_LEVEL=<LOG_LEVEL> -e C64BRIDGE_CONFIG=<C64BRIDGE_CONFIG> -e C64_MODE=<C64_MODE> -e C64U_HOST=<C64U_HOST> -e C64U_PORT=<C64U_PORT> c64-bridge npx -y c64bridgeВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о C64 Bridge
Как установить C64 Bridge в Claude Code?
Добавьте сервер командой claude mcp add c64bridge -e C64U_PASSWORD=<C64U_PASSWORD> -e GITHUB_TOKEN=<GITHUB_TOKEN> -- npx -y c64bridge. Второй вариант — с явными переменными: `claude mcp add --env LOG_LEVEL=<LOG_LEVEL> --env C64BRIDGE_CONFIG=<C64BRIDGE_CONFIG> --env C64_MODE=<C64_MODE> --env C64U_HOST=<C64U_HOST> --env C64U_PORT=<C64U_PORT> --transport stdio c64-bridge -- npx -y c64bridge`.
Что делает C64 Bridge?
Даёт агенту инструменты для работы с Commodore 64: запуск программ, доступ к памяти, графика, звук, диски и печать. Бэкендом может быть железо C64 Ultimate, картридж U2 или эмулятор VICE.
Нужен ли эмулятор, если есть реальная машина?
Нет, VICE опционален: сервер работает с железом C64 Ultimate, Ultimate 64 и U2-семейством. Если оба бэкенда настроены, между ними можно переключаться в ходе сессии через c64_select_backend.
