Ultimate 64 系列主板和卡带的 MCP 服务器
概览
⚠️ 这是一个 alpha 版本。它已经用我自己的 Ultimate 主板和家庭网络系统测试过，但我还没有全面测试所有配置组合和 API 端点。把这当作一个起点，玩玩玩玩吧！欢迎大家贡献、反馈和反馈。 这是官方现代Commodore 64电脑的服务器。该服务器使Claude、ChatGPT和Cursor等AI助手能够通过Ultimate的REST API控制你的C64。 这是官方的康懋达产品——现代时代全新的康懋达64。内部采用了由Gideon Zweijtzer设计的FPGA主板的改良版。它不是模拟器——而是真正的康懋达64，周期精确，采用现代技术打造。 Commodore 64 Ultimate 配备了 USB 存储、以太网、HDMI 输出以及强大的远程控制 REST API。该 MCP 服务器利用该 REST API，让 AI 助手能够直接与 C64 交互。
概述（AI 翻译）
⚠️ Alpha 版本
这是一个测试版。它已经用我自己的Ultimate主板和家庭网络进行了测试，但我还没有对所有配置组合和API端点进行全面测试。把这里当作一个开始，玩玩和享受乐趣吧！欢迎大家贡献、报告错误和反馈。
一个模型上下文协议（MCP）服务器，用于Commodore 64 Ultimate——官方现代Commodore 64电脑。该服务器使Claude、ChatGPT和Cursor等AI助手能够通过Ultimate的REST API控制你的C64。
🎯 这是什么？
Commodore 64 终极版
Commodore 64 Ultimate 是官方 Commodore 产品——现代时代全新的 Commodore 64。内部采用了由 Gideon’s Logic 的 Gideon Zweijtzer 设计的 Ultimate 64 FPGA 主板的修订版。它不是模拟器——它是真正的 Commodore 64，周期精确且采用现代技术制造。
Commodore 64 Ultimate 配备了 USB 存储、以太网、HDMI 输出以及强大的远程控制 REST API。该 MCP 服务器利用该 REST API，让 AI 助手能够直接与 C64 交互。
也兼容
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
Commodore 64 Ultimate — MCP Server
⚠️ Alpha Release
This is an alpha release. It has been tested with my own Ultimate boards and home network setup, but I have not extensively tested all configuration combinations and API endpoints. Consider this a starting point to play and have fun with! Contributions, bug reports, and feedback are welcome.
A Model Context Protocol (MCP) server for the Commodore 64 Ultimate — the official modern Commodore 64 computer. This server enables AI assistants like Claude, ChatGPT, and Cursor to control your C64 via the Ultimate’s REST API.
🎯 What is This?
The Commodore 64 Ultimate
The Commodore 64 Ultimate is an official Commodore product — a brand new Commodore 64 for the modern era. Inside, it uses a revision of the Ultimate 64 FPGA mainboard designed by Gideon Zweijtzer of Gideon’s Logic. It’s not an emulator — it is a real Commodore 64, cycle-accurate and built with modern technology.
The Commodore 64 Ultimate features USB storage, ethernet, HDMI output, and a powerful REST API for remote control. This MCP server leverages that REST API to let AI assistants interact with the C64 directly.
Also Compatible With
This server also works with other products from Gideon’s Logic:
| Device | Description |
|---|---|
| Ultimate 64 | The original FPGA-based Commodore 64 mainboard by Gideon’s Logic. |
| Ultimate II+ | A cartridge for your original Commodore 64 or C128, adding USB storage, ethernet, drive emulation, and more. |
All Ultimate devices expose the same REST API that this MCP server uses.
What Does This MCP Server Do?
This MCP server acts as a bridge between AI assistants and your Commodore 64 Ultimate (or other Ultimate devices), translating natural language commands into API calls. With it, you can:
- Load and run C64 programs (PRG, SID, MOD files)
- Read/write C64 memory directly
- Mount and create disk images (D64, D71, D81)
- Control drive emulation
- Manage device configuration
- Stream audio/video (Ultimate 64 only)
✨ Features
- 37 Tools covering all major Ultimate device functionality
- Dual Transport Modes: STDIO (local) and SSE (remote/hosted)
- Docker Support: Easy containerized deployment
- Dynamic Connection: Set C64 connection at runtime
- Upload PRG via Base64/URL: Run programs from anywhere
- Secure by Default: Non-root Docker container
📋 Available Tools
Connection Management
安装
docker run -p 8000:8000 -e C64_HOST=192.168.1.64 ultimate64-mcp配置
{
"mcpServers": {
"ultimate64-mcp": {
"transport": {
"type": "sse",
"url": "http://your-server-address:8000/sse"
}
}
}
}