C64 Reverse Engineering MCP

C64逆向工程MCP

C64RE MCP是一个以项目为中心的逆向工程工作台，用于 Commodore 64软件。它结合了确定性提取工具 持久知识层、LLM工作流契约、工作区UI、VICE 集成和TypeScript无头C64/1541运行时。

无头运行时很重要，但它是更大系统的一个子系统 C64RE项目。该项目的目标不仅仅是启动软件。目标是 转动磁盘、墨盒、PRG、痕迹、屏幕截图、拆卸和 LLM的研究成果转化为跨课程的持久项目知识。

它的作用

• 通过确定性工具分析PRG、CRT、D64和G64输入
• 发出并验证反汇编/源工件
• 将语义知识存储为实体、发现、关系、流，

任务、开放式问题和已注册工件

• 构建工作区UI使用的稳定JSON视图
• 将VICE公开为外部oracle、调试器和跟踪源
• 为CLI/MCP/LLM工作流公开TypeScript无头运行时
• 支持运行时证据、跟踪、快照、监视器操作，以及

未来的人体模拟器UI功能

为什么选择法学硕士

传统的反汇编程序可以识别代码和数据，但他们不知道 代码的含义。C64RE将确定性事实与语义分离 解释：

• 确定性工具提取字节、文件、存储体、扇区、外部参照，

报告和候选片段

• 法学硕士以结构化的方式记录假设、解释和决策

项目知识

• 来自VICE或Headless的运行时证据证实或反驳了这些

假设

• UI呈现后端生成的视图，而不是成为第二个视图

分析引擎

预期的结果不仅仅是 segment $7C21-$7F4F contains code但是 this routine is the loader-side dispatcher that switches from KERNAL serial into the custom fastloader and then hands control to the scene init.

建筑

┌───────────────────────────────────────────────────────────────┐
│ LLM clients / human users                                      │
│ Claude Code · Codex · Cursor · Browser UI                     │
└──────────────────────────────┬────────────────────────────────┘
                               │ MCP tools / HTTP / WebSocket
                               ▼
┌───────────────────────────────────────────────────────────────┐
│ C64RE MCP Server                                               │
│                                                               │
│ deterministic tools                                            │
│ - TRXDis analysis / disassembly                                │
│ - CRT, disk, G64, compression, BWC helpers                     │
│ - C64Ref ROM lookup, sandbox, build helpers                    │
│                                                               │
│ project knowledge                                              │
│ - artifacts · entities · findings · relations                  │
│ - flows · tasks · open questions · views                       │
│                                                               │
│ runtime evidence                                               │
│ - VICE runtime / monitor / traces                              │
│ - Headless TS C64 + 1541 runtime                               │
│ - DuckDB trace store / swimlanes / snapshots                   │
└──────────────────────────────┬────────────────────────────────┘
                               │ view models / runtime streams
                               ▼
┌───────────────────────────────────────────────────────────────┐
│ User Interfaces                                                │
│                                                               │
│ Workspace UI                                                   │
│ - dashboard · docs · memory · cartridge · disk                 │
│ - load sequence · flow graph · annotated listing · activity    │
│                                                               │
│ Emulator UI / V3 workbench                                     │
│ - live C64 screen · media · monitor · inspector                │
│ - keyboard / joystick · trace swimlanes · frozen explore       │
└───────────────────────────────────────────────────────────────┘

详细演练：

• docs/workflow.md --RE工作流合同
• 文档/语义-ui-layer.md --知识

存储和工作区UI

• docs/project-knowledge-layer.md —

项目知识内部

• EPIC_ROADMAP.md --当前V1/V2/V3路线图

设置

git clone https://github.com/Jondalar/C64ReverseEngineeringMCP.git
cd C64ReverseEngineeringMCP
npm install
npm run build

捆绑的TRXDis管道是自动构建的。

环境变量

克劳德代码

添加 .mcp.json 在RE项目根：

{
  "mcpServers": {
    "c64-re": {
      "command": "npx",
      "args": ["tsx", "/path/to/C64ReverseEngineeringMCP/src/cli.ts"],
      "env": { "C64RE_PROJECT_DIR": "/path/to/your/re-project" }
    }
  }
}

使用完整路径 npx 如果你的shell使用 nvm.

法典

[mcp_servers.c64re]
command = "zsh"
args = ["-lc", "cd /path/to/C64ReverseEngineeringMCP && NODE_NO_WARNINGS=1 ./node_modules/.bin/tsx src/cli.ts"]
env = { C64RE_PROJECT_DIR = "/path/to/your/re-project" }

工作区UI

工作区UI是项目知识浏览器。

npm run ui:build
npm run ui:serve            # API + bundled UI on http://127.0.0.1:4310
npm run ui:dev              # Vite live reload on http://127.0.0.1:4311

看 文档/语义-ui-layer.md.

仿真器UI/V3工作台

V3 UI是面向人类的模拟器工作台，由相同的 无头运行时和项目API。

npm run v3:server           # runtime WebSocket/API server
npm run ui:v3:dev           # V3 browser client

当前的用户体验规范存在于350系列中：

• 规格/350-模拟器工作台-ux-master.md
• 规格/351-模拟器-活机器-ux.md
• 规格/352-模拟器-监视器-兼容-ux.md
• 规格/353-模拟器-媒体项目-flow-ux.md
• 规格/354-模拟-冷冻-冷冻-知识库-ux.md
• 规格/355-模拟器-轨迹-泳道-工作台-ux.md
• 规格/356-仪表板发射模拟器-ux.md
• 规格/357-浏览器键盘-虚拟-游戏杆-ux.md

刀具表面

按区域文档：

工作流程

活动工作流是项目优先的：

1. 初始化或审核项目工作区
2. 注册真实的输入媒体和源工件
3. 运行确定性提取/拆卸
4. 将输出导入项目知识
5. 记录语义发现、任务、未决问题和关系
6. 仅当运行时证据回答了具体问题时，才收集运行时证据
7. 将跟踪/快照聚合为可重用的工件
8. 重建UI视图

无头跑步和VICE跑步是证据提供者。他们的输出应该是 注册为工件并链接回发现/实体，而不是 只活在控制台日志或松散的降价中。

标准规划文件：

• 计划.md --代理的短指针
• EPIC_ROADMAP.md --V1/V2/V3产品路线图
• BUGREPORT.md --bug跟踪器
• 要求.md --细化积压
• specs/ --实施规范和ADR跟进

许可证

麻省理工学院