用AI控制你的Commodore 64 Ultimate设备。这个MCP服务器允许Claude和其他AI助手通过你的本地网络与你的C64 Ultimate硬件交互。

你能做什么？

创建和调试程序 - Claude可以编写C64 BASIC或机器码程序，运行它们，截屏查看结果，检查内存，并迭代修复问题。描述你想要的内容，然后观看Claude在真实硬件上开发。

编写并运行BASIC程序 - 让Claude编写BASIC程序，它会对代码进行分词化，直接注入到C64内存中并运行。无需输入。

玩经典游戏和演示 - 加载并运行。PRG程序或。从设备存储中获取CRT卡带图像，或直接上传。

听SID音乐 - 播放经典的C64 SID曲目或Amiga MOD追踪文件。只需指向设备上的文件或上传即可。

查看屏幕上的内容 - 从任何图形模式截取截图：文本、多彩、雇佣点阵等。Claude可以看到发生了什么并做出相应反应。

输入与控制 - 发送按键、导航菜单，并通过键盘缓冲区与运行中的程序交互。

Commodore 64 Ultimate MCP Server

Control your Commodore 64 Ultimate device with AI. This MCP server lets Claude and other AI assistants interact with your C64 Ultimate hardware over your local network.

What Can You Do?

Create and Debug Programs - Claude can write C64 BASIC or machine code programs, run them, capture the screen to see the results, inspect memory, and iteratively fix issues. Describe what you want and watch Claude develop it on real hardware.

Write and Run BASIC Programs - Ask Claude to write a BASIC program and it will tokenize the code, inject it directly into C64 memory, and run it. No typing required.

Play Classic Games and Demos - Load and run .PRG programs or .CRT cartridge images from your device’s storage or upload them directly.

Listen to SID Music - Play classic C64 SID tunes or Amiga MOD tracker files. Just point to a file on your device or upload one.

See What’s on Screen - Capture screenshots from any graphics mode: text, multicolor, hires bitmap, and more. Claude can see what’s happening and respond accordingly.

Type and Control - Send keystrokes, navigate menus, and interact with running programs through the keyboard buffer.

Manage Floppy Drives - Mount and unmount D64/D71/D81 disk images, switch between 1541/1571/1581 emulation modes, and create new disk images.

Read and Write Memory - Inspect and modify C64 memory directly via DMA. Useful for debugging, poking values, or examining program state.

Configure Your Device - Adjust device settings, save configurations to flash, and manage your C64 Ultimate setup.

How It Works

This server implements the Model Context Protocol (MCP) to expose the C64 Ultimate REST API as tools that AI assistants can use. When connected to Claude Desktop or another MCP client, you can have natural conversations about your C64 and Claude will use these tools to carry out your requests.

Prerequisites

Enable Web Remote Control Service from the C64 Ultimate menu:

• Navigate to: Network Settings → Web Remote Control Service → Enabled

Installation

cd c64u-mcp-server
uv sync

Configuration

Set the C64U_URL environment variable to your device’s IP address:

export C64U_URL="http://192.168.200.157"

Default: http://192.168.200.157

Running the Server

uv run python server.py

Claude Desktop Configuration

Add to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "commodore64": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/c64u-mcp-server", "python", "server.py"],
      "env": {
        "C64U_URL": "http://192.168.200.157"
      }
    }
  }
}

Available Tools

Machine Control

• machine_reset - Reset the C64
• machine_reboot - Reboot Ultimate device
• machine_pause - Pause CPU via DMA
• machine_resume - Resume from pause
• machine_poweroff - Power off (U64 only)