适合谁
- 同时拥有 Ultimate 系列硬件或 VICE 模拟器并希望用 AI 辅助 C64 开发的复古计算爱好者
- 从事 BASIC / 6502 汇编、SID 音乐或 PETSCII 图形创作的开发者
- 需要 AI 智能体在真实硬件与模拟器间自动化测试 C64 程序的团队
C
58FMRS · C
C64 Bridge 是一个功能全面、文档详尽的社区开源 MCP 服务器（GPL-2.0，npm 包 c64bridge，v1.0.2），通过 17 个分组工具将 AI 客户端与 C64 Ultimate / Ultimate 64、U2 系列卡带和 VICE 模拟器连接起来，覆盖编程、内存、图形、音频、存储、打印和知识检索。它并非 Commodore 官方产品，但已列入官方 MCP Registry，并内置大量面向 LLM 的安全与知识资源，适合认真从事 C64 复古开发的用户；无相关硬件或模拟器者则不适用。
C64 Bridge 是一个基于官方 TypeScript MCP SDK 构建的 MCP 服务器，让 AI 智能体通过一个入口控制 Commodore 64 环境。它支持 C64 Ultimate、Ultimate 64、U2 系列卡带（U2/U2+/U2+L）以及 VICE 模拟器，可在运行时通过 c64_select_backend 切换后端。它提供 17 个分组工具、27 个资源（涵盖 BASIC、6510 汇编、SID、VIC-II、内存映射、KERNAL、打印机等知识）和 10 个提示词，可运行 BASIC 和 6510 汇编程序、读写内存、渲染 PETSCII 图形和精灵、播放与合成 SID 音乐、管理磁盘与驱动器、控制打印机，并提供可选的 RAG 知识检索。服务器通过 stdio 传输，附带一个仅供手动测试的可选 HTTP 桥接。
工具能力
c64_batch
在单个请求中执行多个 c64bridge 工具调用，降低多步骤工作流的延迟。
c64_config
配置读写、诊断和快照的分组入口，包括固件版本、调试寄存器和程序随机轮播。
c64_debug
VICE 调试器操作的分组入口：断点（检查点）、寄存器读写、单步执行与等待 CPU 状态。
c64_disk
磁盘挂载、镜像创建、文件元数据查看和 PRG/CRT 程序查找运行的分组入口。
c64_drive
驱动器电源、仿真模式（1541/1571/1581）、IEC 复位和 ROM 加载的分组入口。
c64_extract
精灵与字符集提取、内存转储、文件系统统计和固件健康检查的分组入口。
c64_graphics
帧捕获、PETSCII 艺术与文本渲染、位图导入和精灵显示的分组入口。
c64_input
跨平台 PETSCII 输入以及原生 Ultimate 键盘矩阵和摇杆事件的分组入口。
c64_memory
内存读写、填充、搜索、复制、比较、反汇编、屏幕读取与轮询的分组入口。
c64_printer
Commodore 与 Epson（ESC/P）打印辅助工具的分组入口，含文本与位图打印。
c64_program
程序上传与执行的分组入口：BASIC v2、6502/6510 汇编、PRG、CRT 及批量运行。
c64_rag
从本地知识库检索 BASIC 和 6502/6510 汇编参考的分组入口。
c64_select_backend
在不重启服务器的情况下，在 C64U/U64 硬件、U2 系列卡带和 VICE 模拟器之间切换活动后端。
c64_sound
SID 音乐控制、播放、作曲（SIDWAVE/CPG）、预设演奏、录制与分析的分组入口。
c64_stream
启动和停止 Ultimate 视频流会话的分组入口（仅限 C64U/U64）。
c64_system
电源、复位、暂停/恢复、菜单屏幕读取和后台任务管理的分组入口。
c64_vice
读取和更新选定 VICE 配置资源的分组入口（仅限安全前缀）。
安装接入
需要 Node.js 24+ 和 npm。最简启动方式为 npx -y c64bridge@latest。在 MCP 客户端配置（如 .vscode/mcp.）中添加服务器条目：command 为 npx，args 为 ["-y","c64bridge@latest"]，并可通过 env 设置 C64_MODE（c64u/u2/vice）、C64U_HOST、C64U_PORT、C64U_PASSWORD、VICE_BINARY、VICE_VISIBLE、VICE_WARP 等变量。后端配置也可通过 C64BRIDGE_CONFIG 指定的 JSON 文件（默认 ~/.c64bridge.）提供。
claude_desktop_config.json
{"servers":{"c64bridge":{"command":"npx","args":["-y","c64bridge@latest"]}}}
选型与风险
不适合谁
- 没有任何 C64 硬件或 VICE 模拟器的用户（服务器无可用后端）
- 寻求完全托管云服务、无需本地配置的初学者
- 非 Commodore 64 的其他复古平台（本服务器仅面向 C64）
所需权限
- 通过网络（REST，默认 80 端口）访问 C64 Ultimate / Ultimate 64 / U2 卡带，可选网络密码以 X-Password 头发送
- 启动并管理本地 VICE 模拟器进程及其 Binary Monitor（默认 127.0.0.1:6502）
- 读写本地文件：配置文件、内存/屏幕转储、诊断文件及输出工件
- 可选：GITHUB_TOKEN 用于对 GitHub 进行 RAG 文档发现；可选调用外部工具 sidplayfp 生成音频
风险与副作用
- 该服务器可写入内存、控制电源/复位并管理驱动器，误操作可能中断正在运行的 C64 程序或固件状态
- 网络密码和 GitHub Token 通过环境变量以明文形式传递，需注意凭据泄露
- 可选 HTTP 桥接默认关闭，若启用且无保护，可能允许本机任意客户端调用工具
- U2 系列卡带功能受限（无机器输入、调试寄存器、断电或流式传输）；部分操作依赖较新固件（如 U64 3.15+），旧固件会导致操作不可用
常见排障
- 确认 Node.js 24+ 已安装并在 PATH 中（node --version 应显示 v24.x）
- 确认 C64_MODE 与实际后端匹配，且硬件主机名/IP、端口和密码正确（可用 c64://platform/status 检查活动后端）
- 检查 C64U 固件是否提供 machine:input / machine:menu_screen 端点（或 U64/U2 固件 3.15+），否则原生键盘输入和菜单屏幕读取不可用
- VICE 启动失败时检查 VICE_BINARY 与 VICE_DIRECTORY 是否正确，或确认 x64sc/x64 在 PATH 上
- 工具不出现时，确认服务器已在对应范围（scope）被客户端批准，且 LOG_LEVEL=debug 的日志显示连通性检查通过
使用场景
让 AI 客户端编写并运行 C64 BASIC 或 6510 汇编程序并验证屏幕输出
渲染 PETSCII 艺术图与精灵，导入位图显示
SID 音乐播放、作曲（SIDWAVE）与音频分析
内存检查、反汇编、磁盘镜像管理与固件配置
通过 c64_select_backend 在真实硬件与 VICE 模拟器之间无缝切换
支持客户端
VS Code (GitHub Copilot)完整支持
Claude Code完整支持
Cursor完整支持
Visual Studio完整支持
VS Code Insiders完整支持