C64 Bridge MCP Server

社区

用 AI 客户端控制并编写 Commodore 64 的 MCP 服务器

分类: 开发工具第 147 / 438
Stars: ★ 39 热门
传输方式: stdio（本地进程）
运行环境: Node.js 24+
凭据: 无需凭据
许可证: GPL-2.0
最近提交: 8 天前
工具数: 17

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 复古开发的用户；无相关硬件或模拟器者则不适用。

最强项 · 文档质量 17/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

10/20

维护活跃度

11/20

文档质量

17/20

安装易用性

13/20

查看各项评分依据

可靠性 7/20: README 描述了 stdio 启动流程、启动时的连通性探测,以及针对 17 个工具的详细操作表,行为描述具体、可核对。但本次静态审查未获得实际仓库文件(测试代码、CI workflow 文件本身),只看到 README 中引用的 build/test 脚本和 CI/Codecov 徽章,这些是未经验证的自述证据,不能确认关键路径(如 C64U/VICE 双后端切换、固件版本探测降级逻辑)真的有对应测试覆盖。按静态校准规则,没有可验证的执行证据时可靠性不得超过 12 分;鉴于证据缺口较大,给 7 分。
安全与权限 10/20: 服务器对敏感项处理较规范:C64U_PASSWORD、GITHUB_TOKEN 均标记 isSecret,配置文件加载顺序和合并规则说明清楚。但存在多个可直接调用、无需二次确认的高影响操作,如 c64_system 的 poweroff/reboot/power_cycle、c64_config 的 reset_defaults/save_flash、c64_debug 的 nuclear_reset,均没有 confirm 类参数或人工确认门槛,完全依赖客户端自行把关。VICE 模式下 run_prg 等操作会读取宿主机本地路径,存在主机文件系统边界跨越。RAG 功能可选地使用 GITHUB_TOKEN 访问 GitHub,权限范围文档未说明。这些问题尚不构成红线级别的恶意行为或数据窃取,但权限收敛与操作确认机制明显不完整,故评为 10 分。
维护活跃度 11/20: 仓库为 GPL-2.0 许可、非归档状态,npm 已发布版本 1.0.2,并声称有 CI 与 Codecov 集成,说明存在一定工程化维护。但 33 星、仅 1 个未解决 issue 的规模较小,且本次审查缺乏提交历史、发布频率、issue 响应时间等可验证信号,无法判断长期可持续性和治理规范程度,故给予中等偏下的 11 分。
文档质量 17/20: 文档质量很高:README 按模块清晰组织了配置文件顺序与合并规则、多后端(C64U/U2/VICE)差异表、环境变量参考表(含默认值和对应 JSON 配置键)、固件版本依赖的显式说明、以及自动生成的完整工具/资源/提示清单及每个操作的必填/可选参数和平台支持矩阵。同时提供了多种客户端(VS Code、Claude Code、Cursor)的具体接入示例。扣分点在于缺少独立的“已知限制/常见故障排查”章节,以及部分操作(如 machine:input 的固件依赖)的具体故障提示分散在正文而非集中的排错部分,故未给满分,评为 17 分。
安装易用性 13/20: 提供了 Node 24+ 安装步骤(含多平台命令)、三种启动方式(npx/本地安装/源码构建)、多个主流客户端的一键安装徽章及 JSON 配置示例,后端选择与覆盖规则说明详尽,整体设置路径清晰。但静态审查未见到可验证的执行日志或集成测试证明这些安装路径确实跑通,按静态校准规则安装易用性不得超过 15 分;同时依赖外部固件版本、VICE 二进制自动探测等环境相关因素,存在一定实际部署的脆弱性,故评为 13 分。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么写入 / 删除本地文件执行命令或代码访问网络

适合谁

同时拥有 Ultimate 系列硬件或 VICE 模拟器并希望用 AI 辅助 C64 开发的复古计算爱好者
从事 BASIC / 6502 汇编、SID 音乐或 PETSCII 图形创作的开发者
需要 AI 智能体在真实硬件与模拟器间自动化测试 C64 程序的团队

不适合谁

没有任何 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+

C64U_PASSWORD 可选密钥 Ultimate 64 网络密码（若已在设备网络设置中启用），以 X-Password 头发送。

U2_PASSWORD 可选密钥 U2 家族网络密码，以 X-Password 头发送，仅在 C64_MODE=u2 时使用。

GITHUB_TOKEN 可选密钥 GitHub 个人访问令牌，仅用于可选的基于 GitHub 的 RAG 文档发现，可从 GitHub Settings > Developer settings 生成。

其他可选配置项（13 个）

C64_MODE 可选选择初始后端（c64u、u2 或 vice），默认 c64u。

C64BRIDGE_CONFIG 可选指向 C64 Bridge 配置 JSON 文件的路径，默认 ~/.c64bridge.。

LOG_LEVEL 可选日志详细程度，可选 debug/info/warn/error。

C64U_HOST 可选 Ultimate 64 主机名或 IP 地址，默认 c64u。

C64U_PORT 可选 Ultimate 64 REST 端口，默认 80。

U2_HOST 可选 U2/U2+/U2+L 磁带盒的主机名或 IP，仅在 C64_MODE=u2 时使用。

U2_PORT 可选 U2 家族 REST 端口，仅在 C64_MODE=u2 时使用。

VICE_BINARY 可选要启动的 VICE 模拟器二进制文件，默认 x64sc。

VICE_DIRECTORY 可选 VICE 资源目录（ROM/UI 资源），用于自动检测失败时覆盖。

VICE_VISIBLE 可选设为 true 启动可见桌面窗口，false 时使用无头 Xvfb。

VICE_WARP 可选启用 VICE warp 模式（加速运行）。

VICE_ARGS 可选转发给托管 VICE 启动的额外命令行参数，例如 -minimized。

VICE_PREWARM 可选设为 1 时在 MCP 启动期间后台启动/连接 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.）提供。

.mcp.json

{"servers":{"c64bridge":{"command":"npx","args":["-y","c64bridge@latest"]}}}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "c64bridge": {
      "command": "npx",
      "args": [
        "-y",
        "c64bridge@latest"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add c64bridge -- npx -y c64bridge@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端中确认 c64_program、c64_memory、c64_select_backend 等工具已出现，然后让客户端用 vice 后端执行一个打印 HELLO 的 BASIC 程序并读取屏幕验证输出。

常见排障

确认 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 助手这样说：

c64u: 写一个清屏并打印 HELLO C64U 的 BASIC 程序并运行
vice: 写一个小的 BASIC 程序清屏并打印 HELLO VICE
u2: 列出当前挂载的磁盘驱动器
读取当前屏幕内容并告诉我显示了什么

工具能力 17

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 键盘矩阵和摇杆事件的分组入口。

展开其余 9 个工具

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 配置资源的分组入口（仅限安全前缀）。

使用场景

让 AI 客户端编写并运行 C64 BASIC 或 6510 汇编程序并验证屏幕输出

渲染 PETSCII 艺术图与精灵，导入位图显示

SID 音乐播放、作曲（SIDWAVE）与音频分析

内存检查、反汇编、磁盘镜像管理与固件配置

通过 c64_select_backend 在真实硬件与 VICE 模拟器之间无缝切换

支持客户端

GitHub Copilot

Claude Code

Cursor

Visual Studio

VS Code Insiders

依据项目文档列出，未经本站实测。

详细介绍

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 桥接。