关键词

Commodore 64AI编程复古计算机SID音乐PETSCII艺术

项目简介

C64 Bridge 是一个创新的 Model Context Protocol (MCP) 服务器，它将人工智能的能力扩展到经典的 Commodore 64 平台。通过连接 Commodore 64 Ultimate 硬件或 VICE 模拟器，C64 Bridge 允许 LLM 客户端（如 GitHub Copilot Chat）执行编程、创作音乐、生成 PETSCII 艺术、管理存储、控制内存及进行系统诊断等操作，为 Commodore 64 注入了AI驱动的智能。

主要功能点

  • 程序执行与管理：LLM 代理可以上传并运行 BASIC 或 6502 汇编程序，以及加载和运行 PRG 或 CRT 格式的文件。
  • 内存与系统控制：实现读写 C64 内存、控制 VIC-II 视频芯片和 SID 音频芯片、暂停/恢复机器运行、执行软复位或固件重启等低层级操作。
  • 音频合成与分析：支持 SID 音乐创作，包括音符触发、波形控制、ADSR 包络设置，并能分析 SID 播放的音频特性。
  • 图形与艺术生成：能够创建 PETSCII 艺术作品，生成并显示精灵（Sprite），以及渲染自定义屏幕内容。
  • 存储设备管理：提供对 Ultimate 64 文件系统的访问，允许列出驱动器、挂载/卸载磁盘镜像（D64, D71, D81, DNP）、创建空白磁盘文件以及检查文件信息。
  • 打印功能：支持通过 Commodore MPS 或 Epson FX 设备进行文本和位图打印，甚至可以定义自定义字符。
  • 本地知识库RAG：内置检索增强生成（RAG）功能，为 LLM 提供关于 BASIC 语法、6502 汇编、SID 编程和 VIC-II 图形等领域的上下文知识和示例。
  • 会话与诊断：提供版本信息、硬件状态查询，支持配置管理和背景任务调度，并能够进行流式数据传输（视频、音频、调试信息）。

安装步骤

  1. 安装 Node.js: C64 Bridge 需要 Node.js 18+ (推荐 20+ 版本) 和 npm。根据您的操作系统选择以下安装方式：

    • Linux (Ubuntu/Debian): 
      sudo apt update
sudo apt install -y curl ca-certificates
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
    • macOS: 
      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # 如果未安装 Homebrew
brew install node@20
brew link --overwrite node@20
    • Windows: 
      # Option A: winget (Windows 10/11)
winget install OpenJS.NodeJS.LTS
# Option B: Chocolatey
choco install nodejs-lts -y

    安装完成后，请通过 'node --version' 确认 Node.js 版本。

  2. 安装并运行 MCP 服务器: 您可以通过以下两种方式快速启动服务器：

    • 使用 npx (推荐快速启动): 在终端运行 'npx -y c64bridge@latest'。这将下载并运行最新版本的服务器，无需本地项目设置。

    • 通过 npm 持久安装:

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

服务器配置

C64 Bridge MCP 服务器需要一个配置文件 ('.c64bridge.json') 来指定连接的 Commodore 64 设备。该文件可以在以下位置查找（按优先级从高到低）：

  1. 'C64BRIDGE_CONFIG' 环境变量指定的绝对路径。
  2. '~/.c64bridge.json' (用户主目录)。
  3. './c64bridge.json' (当前工作目录)。

如果未找到配置文件，服务器将使用默认值 'host=c64u', 'port=80'。

用于MCP客户端的配置信息示例 (JSON格式，非代码):

{
  "name": "c64bridge",
  "command": "npx",
  "args": ["c64bridge@latest"],
  "description": "连接到 Commodore 64 Ultimate 或 VICE 模拟器，使用 AI 进行编程、音乐创作和系统控制。",
  "configuration": {
    "c64u": {
      "type": "object",
      "description": "配置 Commodore 64 Ultimate 硬件设备的连接信息。",
      "properties": {
        "host": {
          "type": "string",
          "description": "Commodore 64 Ultimate 设备的IP地址或主机名 (例如: 192.168.1.64 或 c64u)。",
          "default": "c64u"
        },
        "port": {
          "type": "integer",
          "description": "Commodore 64 Ultimate 设备的REST API端口 (通常为 80)。",
          "default": 80
        }
      }
    },
    "vice": {
      "type": "object",
      "description": "配置 VICE 模拟器的连接信息。此为实验性功能。",
      "properties": {
        "exe": {
          "type": "string",
          "description": "VICE 模拟器可执行文件的路径 (例如: /usr/bin/x64sc)。如果未指定，服务器将尝试在 PATH 中查找 'x64sc' 或 'x64'。",
          "default": "x64sc"
        }
      }
    }
  },
  "notes": "建议创建一个 ~/.c64bridge.json 文件来配置您的 C64 Ultimate 设备。例如: { \"c64u\": { \"host\": \"您的设备IP或主机名\", \"port\": 80 } }"
}

基本使用方法

  1. 配置C64设备: 创建 '~/.c64bridge.json' 文件并添加您的 Commodore 64 Ultimate 设备的 'host' 和 'port'。例如：

    {
  "c64u": {
    "host": "192.168.1.64",
    "port": 80
  }
}

  2. 启动MCP服务器: 按照上述“安装并运行 MCP 服务器”的步骤启动服务器。例如，使用 npx：

    npx -y c64bridge@latest

    服务器将在 'stdio' 模式下运行，并在标准错误输出 'stderr' 中打印日志。

  3. 连接LLM客户端 (例如 VS Code 中的 GitHub Copilot Chat):

    • 在 VS Code 中，打开 设置 → 扩展 → GitHub Copilot → Chat: Experimental: MCP，并启用 MCP。重启 VS Code。
    • 通常情况下，MCP 服务器会自动启动。如果未启动，您可以打开 'c64bridge' 仓库根目录下的 '.vscode/mcp.json' 文件，并点击“Start”图标手动启动。
    • 打开 菜单 → 视图 → 聊天，在 Copilot Chat 窗口底部选择 C64 聊天模式。

  4. 运行您的第一个AI指令: 在 Copilot Chat 中输入指令，例如： 'Print a greeting on the screen' C64 Bridge 将通过 MCP 协议与您的 Commodore 64 交互，上传并执行一个 BASIC 问候程序，并在您的 C64 屏幕上显示“HELLO WORLD!”。

信息

分类

AI与计算

访问项目