C64终极MCP服务器

⚙️ 此项目是100%使用AI Agent提示构建的 -每一行代码、配置和文档都是通过GitHub Copilot Agent的对话提示生成的。

全面的 模型上下文协议（MCP） 服务器 Commodore 64终极版 设备与 45+工具 （45次设备操作）， 14个MCP提示，以及 38个嵌入式文档资源.内置C#，具有企业级架构、类型安全和全面的API覆盖范围。

许可证： MIT许可证（见许可证文件）

🎥 演示视频

![C64 Ultimate MCP Server Demo](https://www.youtube.com/watch?v=1q80quIIkV0?cc_load_policy=1&cc_lang_pref=en)

⚡ 主要特点

完整的Ultimate 64 API支持：1541U REST API中的所有45+工具
MCP提示支持：通过公开14个提示模板 prompts/list 和 prompts/get
从BASIC到PRG编译：将BASIC V2源代码实时编译为可执行的PRG文件
MCP资源：38个嵌入式文档资源（BASIC规范、装配指南、Kernal API、内存映射、图形、声音、I/O、驱动器、打印机、键盘/控制代码、反汇编）
独立客户端库：可重复使用 C64UltimateClient 带有干净异步API的NuGet包
整洁架构：客户→ 服务→ 具有适当DI的MCP包装图案
HTTP/SSE传输：具有会话管理的远程多客户端支持
流媒体支持：视频、音频和调试流媒体功能
二进制文件支持：通过base64、文件路径或URL上传PRG文件
ASP。NET核心8.0/10.0：现代高性能web框架
企业配置：带有环境覆盖的appsettings
类型安全：C#静态类型，具有完全空安全性和可空引用类型
结构化日志记录：客户端和服务层的单独记录器
生产就绪：零错误/警告，全面的错误处理
代理集成：适用于Continue、Copilot、Cody、Cursor、Claude Desktop

🚀 快速开始

# 1. Build
dotnet build

# 2. Configure (optional, defaults to http://192.168.0.120)
export Ultimate__BaseUrl=http://your-c64-ultimate-ip:port

# 3. Run
dotnet run

# 4. Server starts on http://localhost:8080

📦 安装

需求

.NET 10.0 SDK - 下载
C64终极设备 -在您的网络上
Curl或HTTP客户端 -用于测试
码头工人 （可选）- 下载

设置

git clone https://github.com/ch0mik/C64UltimateMcpServer.git
cd C64UltimateMcpServer
dotnet build
dotnet run

⚙️ 配置

应用程序参数

{
  "Ultimate": {
    "BaseUrl": "http://192.168.0.120"
  }
}

环境变量

Ultimate__BaseUrl=http://192.168.0.120

码头工人

environment:
  - Ultimate__BaseUrl=http://192.168.0.120

🤖 代理集成

继续IDE（推荐）

安装继续 - https://continue.dev
配置 .continue/config.json:

{
  "models": [
    {
      "title": "Claude",
      "provider": "openai",
      "model": "claude-3-5-sonnet"
    }
  ],
  "mcp_servers": {
    "c64-ultimate": {
      "url": "http://localhost:8080"
    }
  }
}

在聊天中使用:

@C64 reboot the device
@C64 load and run /games/loderunner.prg
@C64 what config categories are available?

VS代码聊天（GitHub Copilot）

安装 -GitHub Copilot聊天扩展
配置 .vscode/settings.json:

{
  "github.copilot.chat.mcpServers": [
    {
      "name": "C64 Ultimate",
      "type": "streamable-http",
      "url": "http://localhost:8080"
    }
  ]
}

使用:

@C64 reboot device
@C64 mount disk /games/disk1.d64

科迪（来源图）

cody mcp add c64-ultimate http://localhost:8080

然后在科迪：

Ask Cody: Use C64 Ultimate MCP to reboot the device
Ask Cody: List all available config categories

光标IDE

配置 .cursor/mcp.json:

{
  "servers": [
    {
      "name": "C64 Ultimate",
      "type": "http",
      "url": "http://localhost:8080"
    }
  ]
}

使用斜线命令:

/c64 reboot device
/c64 load program

🛠️ 工具（共45个）

机器控制（5）

最后通牒_重置_机器 -软复位C64（保留配置）
finale_reboot_device -完全设备重启（重新初始化墨盒）
最后通牒_贫民区_中国 -暂停机器执行
最后通牒_简历_机器 -恢复机器执行
最后通电关闭 -关闭C64电源

项目管理（6）

finale_generate_basic_prg -通过令牌转换从BASIC源代码生成PRG
最后通牒加载程序 -从文件系统加载PRG程序
最后通牒运行程序 -从磁盘加载并执行PRG
finalte_run_prg-binary -从二进制数据、URL或文件执行程序
finale_run_cartridge -加载并运行墨盒
最后通牒菜单按钮 -模拟菜单按钮按下

内存管理（5）

最后通牒_阅读_记忆 -读取C64 RAM内存内容
最后通牒_写_记忆 -写入RAM存储器
最后通牒_写入_内存_二进制 -将二进制数据写入内存
最后通牒_错误_注册 -读取调试寄存器
最后通牒_设置_错误_注册 -写入调试寄存器

音频播放（5）

最后通牒_播放\_ ID -播放带有可选歌曲编号的SID文件
最后通牒_播放_身份_二进制 -从二进制数据、URL或文件播放SID
最后通牒_播放_模式 -播放Amiga MOD文件
最后通牒_启动_流 -启动音频/视频/调试流
最后通牒_停止_流 -停止活动流

驱动器管理（7）

最后通牒_获取_驱动 -获取所有磁盘驱动器的信息
finale_mount_disk -从文件系统或二进制数据装载磁盘映像
最后通牒_卸载_磁盘 -卸载磁盘映像
finale_reset_drive -重置所选磁盘驱动器
finale_set_drive_mode -更改驱动器操作模式
最后通牒 -打开磁盘驱动器电源
最后通牒 -关闭磁盘驱动器电源

磁盘创建（4）

最后通牒_create_d64 -创建1541磁盘映像（D64）
最后通牒_create_d71 -创建1571磁盘映像（D71）
最后通牒_create_d81 -创建1581磁盘映像（D81）
finale_create_dnp -创建本机分区磁盘映像（DNP）

ROM管理（1）

finale_load_drive_rom -将自定义ROM加载到磁盘驱动器

文件管理（1）

最后通牒_获取文件_信息 -获取文件信息

配置管理（6）

最后通牒_配置_类别 -获取可用配置类别列表
最后通牒_获取配置_类别 -获取一个类别中的所有设置
最后通牒_获取配置项 -获取单个配置值
最后通牒_集合_配置项 -设置配置值
最后通牒_批量配置_更新 -一次更新多个设置
finale_load_config -从闪存加载配置

注： ultimate_save_config 和 ultimate_reset_config 也可用于配置管理

连接管理（2）

finale_get_connection -获取当前连接设置
finale_set_connection -更改设备主机名/端口

系统信息（1）

最后版本 -获取C64 Ultimate API版本

💬 提示（共14条）

c64_basic_program_prompt -生成C64 BASIC V2程序的提示模板
c64_sid_music_froment -SID合成指导提示模板

重要提示：提示是MCP提示，而不是工具。\ 使用 prompts/list 和 prompts/get 用于提示，以及 tools/call 仅用于工具。

�️ 总结（共45个工具）

机器控制：5个工具
项目群管理：6个工具
内存管理：5个工具
音频播放：5个工具
驱动器管理：7个工具
磁盘创建：4个工具
ROM管理：1个工具
文件管理：1个工具
配置管理：6个工具
连接管理：2个工具
系统信息：1个工具

�📚 资源（共38个）

嵌入式文档可通过MCP Inspector访问 http://localhost:8000:

基础资源（7）

c64://基本/规范 -BASIC V2语言规范
c64://基本/陷阱 -基本陷阱和常见陷阱
c64://基本/示例/helloworld -Hello World示例
c64://基本/示例/操纵杆 -操纵杆输入示例
c64://基本/示例/反弹 -反弹动画示例
c64://基本/示例/波形 -波浪动画示例
c64://基本/api -BASIC可调用API参考

装配资源（1）

c64://组装/规格 -6510汇编语言规范

内存资源（3）

c64://内存/映射 -C64内存映射（0x0000-0xFFFF）
c64://内存/内核 -内核内存映射（ROM$E000-$FFFF）
c64://内存/低 -低内存映射（0x0000-0x03FF）

图形资源（4）

c64://图形/vic -VIC-II芯片规格
c64://图形/字符集 -字符集参考（ASCII/PETSCII）
c64://图形/调色板 -C64 16调色板参考
c64://图形/样式指南 -图形编程风格指南

声音资源（4）

c64://声音/sid -SID芯片（6581/8580）规格
c64://声音/编程 -SID编程指南
c64://声音/文件格式 -SID文件格式文档
c64://声音/效果 -音效编程技巧

I/O资源（2）

c64://io/cia -CIA芯片规格
c64://io/spec -I/O端口规格

驱动资源（1）

c64://驱动器/规格 -1541/1571/1581磁盘驱动器规格

打印机资源（6）

c64://打印机/通讯器规范 -Commodore打印机规格
c64://打印机/epson规格 -爱普生打印机规格
c64://打印机/commondore位图 -Commodore打印机位图字体
c64://打印机/epson位图 -爱普生打印机位图字体
c64://打印机/图形模式 -图形模式编程指南
c64://打印机/故障排除 -打印机故障排除指南

API资源（2）

c64://api/basic -BASIC V2可调用API参考
c64://api/内核 -Kernal可调用API参考（23个例程）

通过MCP检查器访问资源：

打开http://localhost:8000（MCP检查员）
点击“资源”选项卡
选择任何资源以查看其全部内容
直接复制代码示例和规范

📝 例子

HTTP/cURL

所有HTTP示例都可以在 examples_http/ 文件夹。关键示例：

重启设备 -请参阅 mcp_reboot_device.http:

curl -X POST http://localhost:8080/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "ultimate_reboot_device",
      "arguments": {}
    }
  }'

装载磁盘 -请参阅 mcp_mount_disk.http

运行PRG二进制文件 -请参阅 TEST_RUN_PRG_BINARY.http

播放SID文件 -请参阅 TEST_PLAY_SID_BINARY.http

所有45+工具都有相应的 .http 文件在 examples_http/ 用于测试

列表提示:

curl -X POST http://localhost:8080/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "prompts/list",
    "params": {}
  }'

获取提示:

curl -X POST http://localhost:8080/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "prompts/get",
    "params": {
      "name": "c64_basic_program_prompt",
      "arguments": {
        "goal": "make a starfield",
        "level": "beginner"
      }
    }
  }'

继续IDE

@C64 Create a BASIC program that prints "HELLO WORLD" and run it
@C64 Mount the disk image games.d64 on drive 8
@C64 Reset the C64 and show machine info

BASIC程序示例 -请参阅 mcp_generate_basic_prg.html 将BASIC源代码直接编译为可执行的PRG文件，并创建自己的BASIC PRG二进制文件。

🧪 测试

看 examples_http/ 完整测试示例的文件夹：

测试基本连接:

# HTTP files: test_basic_connection.http
curl http://localhost:8080/health
# Response: "C64 Ultimate MCP Server is running"

列出工具 -请参阅 mcp_list_tools.http

列表提示:

curl -X POST http://localhost:8080/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":7,"method":"prompts/list","params":{}}'

获取版本 -请参阅

测试SID二进制文件上传 -请参阅 TEST_PLAY_SID_BINARY.http

测试PRG二进制文件上传 -请参阅 TEST_RUN_PRG_BINARY.http

中的所有文件 examples_http/mcp_*.http 与可用工具相对应。

🐳 Docker部署

关于MCP检查员

这 MCP检查员 是一个基于网络的工具，用于测试和调试MCP服务器。它提供：

交互式工具探索
实时参数测试
请求/响应检查
WebSocket监控

它会自动连接到MCP服务器，并显示所有可用的工具和详细信息。

选项1：Docker构建

docker compose up --build

在本地构建映像，并启动MCP服务器和检查器。

访问权限：

MCP服务器: http://localhost:8080主MCP服务器端点
MCP检查员: http://localhost:8000-用于测试工具的Web UI

服务：

mcp-server -C64终极MCP服务器（处理所有工具请求）
inspector -MCP检查器UI（连接到MCP服务器http://mcp-server:8080)

选项2：Docker编写简单

docker compose up

启动预构建的容器（与选项1相同，但不重建映像）。

访问权限：

MCP服务器: http://localhost:8080
MCP检查员: http://localhost:8000

选项3:Docker运行（预构建映像）

docker run -p 8080:8080 \
  -e ASPNETCORE_URLS=http://+:8080 \
  -e Ultimate__BaseUrl=http://192.168.0.120 \
  -d sq7mru/c64ultimatemcpserver:latest

访问权限：

MCP服务器: http://localhost:8080

注：此选项仅运行MCP服务器。要同时运行MCP Inspector，请使用选项1或2，或运行单独的检查器容器。

自定义docker-compose.yml

services:
  mcp-server:
    image: sq7mru/c64ultimatemcpserver:latest
    ports:
      - "8080:8080"
    healthcheck:
      test: ["CMD", "sh", "-c", "ps x| grep dotnet | grep C64UltimateMcpServer"]
      interval: 10s
      timeout: 5s
      retries: 10
      start_period: 10s
    environment:
      - Ultimate__BaseUrl=http://192.168.0.120
      - ASPNETCORE_URLS=http://+:8080
      - ASPNETCORE_ENVIRONMENT=Production
    networks:
      - c64-network

  mcp-inspector:
    image: mcpuse/inspector:latest
    container_name: inspector
    command:
      - /bin/sh
      - -c
      - |
        npx @mcp-use/inspector \
          --port 8000 \
        --url http://mcp-server:8080 
    ports:
      - "8000:8000"
    depends_on:
      mcp-server:
          condition: service_healthy
    networks:
      - c64-network

networks:
  c64-network:
    driver: bridge

环境变量

Ultimate__BaseUrl -C64终极设备URL（默认值：http://192.168.0.120)
ASPNETCORE_URLS -服务器绑定（默认：http://+:8080）
ASPNETCORE_ENVIRONMENT -环境模式（生产/开发）

📚 建筑

┌─────────────────────────────────────────────┐
│         AI Agents                           │
│  (Continue/Copilot/Cody/Cursor)             │
└──────────────────┬──────────────────────────┘
                   │ HTTP/SSE
┌──────────────────▼──────────────────────────┐
│      MCP Server (localhost:8080)            │
│  - HTTP Transport Layer                     │
│  - Session Management                       │
│  - Tool Routing                             │
└──────────────────┬──────────────────────────┘
                   │ REST API
┌──────────────────▼──────────────────────────┐
│   C64 Ultimate Device                       │
│   (192.168.0.120:80)                        │
│  - V1 REST API                              │
│  - SID/MOD Playback                         │
│  - Drive Control                            │
│  - Memory Access                            │
└─────────────────────────────────────────────┘

✅ 状态：生产就绪

✅ 为C64 Ultimate操作实施了45种生产工具
✅ 已实施14个MCP提示
✅ 38个嵌入式文档资源
✅ BASIC到PRG的实时编译
✅ HTTP/SSE传输
✅ 代理集成（继续、复制、科迪、光标）
✅ 使用MCP Inspector实现Docker容器化
✅ 零错误/警告
✅ 综合文档
✅ 配置管理
✅ 会话处理

📦 外部资源

外部资源和学习材料：\ 嵌入式MCP资源和C64学习指南工具基于 c64桥 Chris Gleissner的项目。

23嵌入式外部资源 包括：

BASIC V2规范和示例
6510汇编语言指南
C64内存映射
VIC-II、SID、CIA规范
内核API参考（23个可调用例程）
还有更多。..

这些外部资源已被改编和整合为该服务器的MCP资源和学习指南工具。

🔗 链接

C64终极版: https://ultimate64.com/
1541 u API: https://github.com/GideonZ/1541u-documentation
c64桥: https://github.com/chrisgleissner/c64bridge/
复古64: https://retroc64.github.io/
C64U（网络巫师）: https://github.com/cybersorcerer/c64u/
C64U MCP服务器: https://github.com/xphileby/c64u-mcp-server
最终64 MCP: https://github.com/Martijn-DevRev/Ultimate64MCP
MCP规范: https://modelcontextprotocol.io/
继续IDE: https://continue.dev
GitHub Copilot: https://github.com/features/copilot
科迪: https://cody.dev
光标: https://cursor.sh

📄 许可证

麻省理工学院

______________________________________________________________________

🇵🇱 C64终极MCP服务器（Polski）

⚙️ 这个项目是100%使用AI代理提示创建的 - 每一行代码，配置和文档都是通过对话提示到GitHub Copilot Agent生成的。

综合服务器 模型上下文协议（MCP） 对于设备 Commodore 64终极版 z 45+工具 （45 设备操作） 14 速 MCP 我 38篇文献资料采用C#构建，具有企业级架构，类型安全和全面的API覆盖。

🎥 Wideo演示

![C64 Ultimate MCP Server Demo](https://www.youtube.com/watch?v=1q80quIIkV0?cc_load_policy=1&cc_lang_pref=pl)

📋 内容列表

.NET 10.0 SDK - 下载
C64 Ultimate 设备 - 在本地网络
cURL链接HTTP - 用于测试
码头工人 （可选） - 下载

安装（PL）

# 1. Klonuj repozytorium
git clone https://github.com/ch0mik/C64UltimateMcpServer.git
cd C64UltimateMcpServer

# 2. Zbuduj projekt
dotnet build

# 3. Uruchom serwer
dotnet run

# Serwer dostępny na http://localhost:8080

码头工人

docker-compose up
# Serwer: http://localhost:8080
# Inspektor: http://localhost:6274

配置（PL）

应用程序参数

{
  "Ultimate": {
    "BaseUrl": "http://192.168.0.120"
  }
}

可变环境

Ultimate__BaseUrl=http://192.168.0.120

🛠️ 工具（45 次）

机器控制（5）

最后通牒_重置_机器 - 软C64重置（保留配置）
finale_reboot_device - 完全重新启动设备（墨盒重置）
最后通牒_贫民区_中国 停止机器工作
最后通牒_简历_机器 机器恢复工作
最后通电关闭 关闭C64

项目管理（6）

finale_generate_basic_prg - 从BASIC代码生成PRG并转换为令牌
最后通牒加载程序 - 从文件系统加载PRG
最后通牒运行程序 - 从磁盘启动PRG程序
finalte_run_prg-binary - 从二进制数据，URL或文件运行程序
finale_run_cartridge - 启动墨盒
最后通牒菜单按钮 - 模拟按下菜单按钮

记忆管理（5）

最后通牒_阅读_记忆 读取 RAM 内容
最后通牒_写_记忆 - 记录到RAM
最后通牒_写入_内存_二进制 - 将二进制数据写入内存
最后通牒_错误_注册 - 读取调试日志
最后通牒_设置_错误_注册 - 保存到调试日志

音频播放（5）

最后通牒_播放\_ ID - 播放带有指定歌曲号码的SID文件
最后通牒_播放_身份_二进制 - 从二进制数据，URL或文件中播放SID
最后通牒_播放_模式 - 播放MOD文件
最后通牒_启动_流 - 启动音频/视频/调试流
最后通牒_停止_流 停止活动流

磁盘驱动器管理（7）

最后通牒_获取_驱动 - 下载有关所有磁盘驱动器的信息
finale_mount_disk - 从文件系统或二进制数据安装磁盘映像
最后通牒_卸载_磁盘 - 卸载磁盘映像
finale_reset_drive - 重置选定的磁盘驱动器
finale_set_drive_mode 改变工作站模式
最后通牒 - 启用磁盘站
最后通牒 - 关闭磁盘站

创建磁盘（4）

最后通牒_create_d64 创建磁盘映像文件 1541 （D64）
最后通牒_create_d71 - 创建磁盘映像 1571 （D71）
最后通牒_create_d81 - 创建磁盘映像 1581 （D81）
finale_create_dnp 创建原生分区映像（DNP）

管理 ROM （1）

finale_load_drive_rom - 将自定义 ROM 加载到驱动器

文件管理（1）

最后通牒_获取文件_信息 - 下载文件信息

配置管理（6）

最后通牒_配置_类别 - 下载可用的配置类别列表
最后通牒_获取配置_类别 - 下载整个类别的设置
最后通牒_获取配置项 - 获取单个设置的值
最后通牒_集合_配置项 - 更改设置值
最后通牒_批量配置_更新 大规模同时更改多个设置
finale_load_config - 加载配置

请注意： ultimate_save_config 我 ultimate_reset_config 也可用于配置管理

连接管理（2）

finale_get_connection - 下载当前连接设置
finale_set_connection 更改主机/端口以建立连接

系统信息（1）

最后版本 C64 Ultimate 版本

💬 提示（14 次）

c64_basic_program_prompt 生成 C64 BASIC V2 程序的提示模板
c64_sid_music_froment - 创建SID组合提示的提示模板

重要：MCP 提示不是工具。\ 使用 prompts/list 我 prompts/get 对于提示和 tools/call 仅用于工具。

📚 资源（38次）

内置文档可在 MCP Inspector http://localhost:8000:

扎索比基础（7）

c64://基本/规范 BASIC V2语言规格
c64://基本/陷阱 BASIC中的常见错误和陷阱
c64://基本/示例/helloworld 例如 Hello World
c64://基本/示例/操纵杆 操作joystick的例子
c64://基本/示例/反弹 - 反弹球动画示例
c64://基本/示例/波形 波动动画示例
c64://基本/api API BASIC 参考

装配设备（1）

c64://组装/规格 6510汇编语言规格

记忆资源（3）

c64://内存/映射 C64内存映射（0x0000-0xFFFF）
c64://内存/内核 内核内存映射（ROM $E000-$FFFF）
c64://内存/低 低内存映射（0x0000-0x03FF）

图形资源（4）

c64://图形/vic VIC-II系统规格
c64://图形/字符集 字符集参考（ASCII/PETSCII）
c64://图形/调色板 16 色 C64
c64://图形/样式指南 - 图形编程风格指南

音频资源（4）

c64://声音/sid SID 规格（6581/8580）
c64://声音/编程 SID 编程指南
c64://声音/文件格式 - SID文件格式文档
c64://声音/效果 - 音效编程提示

I/O 资源（2）

c64://io/cia CIA系统规格
c64://io/spec I/O 端口规格

硬盘设备（1）

c64://驱动器/规格 - 1541/1571/1581驱动器规格

打印机设备（6）

c64://打印机/通讯器规范 Commodore 打印机规格
c64://打印机/epson规格 Epson打印机规格
c64://打印机/commondore位图 Commodore 打印机位图字体
c64://打印机/epson位图 Epson 打印机位图字体
c64://打印机/图形模式 - 图形模式指南
c64://打印机/故障排除 解决打印机问题

API 资源（2）

c64://api/basic API BASIC V2 参考
c64://api/内核 内核API（23个程序）

通过 MCP Inspector 访问资源：

打开http://localhost:8000 （MCP检查员）
点击“资源”标签
选择任何资源查看其完整内容
直接复制代码示例和规格

🤖 AI代理（PL）

继续IDE（Polecane）

安装 - https://continue.dev
配置 .continue/config.json:

{
  "models": [
    {
      "title": "Claude",
      "provider": "openai",
      "model": "claude-3-5-sonnet"
    }
  ],
  "mcp_servers": {
    "c64-ultimate": {
      "url": "http://localhost:8080"
    }
  }
}

在聊天中使用:

@C64 zrestartuj urządzenie
@C64 załaduj i uruchom /games/loderunner.prg
@C64 jakie kategorie konfiguracji są dostępne?

VS代码聊天（GitHub Copilot）

安装 GitHub Copilot Chat 扩展
配置 .vscode/settings.json:

{
  "github.copilot.chat.mcpServers": [
    {
      "name": "C64 Ultimate",
      "type": "streamable-http",
      "url": "http://localhost:8080"
    }
  ]
}

命令:

@C64 zrestartuj maszynę
@C64 montuj dysk /games/disk1.d64
@C64 pokaż informacje o urządzeniu

科迪（来源图）

cody mcp add c64-ultimate http://localhost:8080

W科迪：

Ask Cody: Use C64 Ultimate to reboot the device
Ask Cody: Pokaz dostepne kategorie konfiguracji

光标IDE

配置 .cursor/mcp.json:

{
  "servers": [
    {
      "name": "C64 Ultimate",
      "type": "http",
      "url": "http://localhost:8080"
    }
  ]
}

Polecenia斜线:

/c64 zrestartuj urządzenie
/c64 załaduj program

例子（PL）

cURL

文件夹中可用的所有 HTTP 实例 examples_http/主要例子：

重新启动设备 - 看 mcp_reboot_device.http:

curl -X POST http://localhost:8080/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "ultimate_reboot_device",
      "arguments": {}
    }
  }'

挂载磁盘 - 看 mcp_mount_disk.http

Uruchom项目PRG - 看 TEST_RUN_PRG_BINARY.http

播放 SID 音乐 - 看 TEST_PLAY_SID_BINARY.http

所有 45+ 工具都有相应的文件 .http 在文件夹中 examples_http/ 用于测试

提示列表:

curl -X POST http://localhost:8080/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "prompts/list",
    "params": {}
  }'

下载提示:

curl -X POST http://localhost:8080/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "prompts/get",
    "params": {
      "name": "c64_sid_music_prompt",
      "arguments": {
        "style": "chiptune",
        "bpm": 120
      }
    }
  }'

继续IDE

@C64 Create a BASIC program that prints "HELLO WORLD" and run it
@C64 Montuj obraz dysku games.d64 na napęd 8
@C64 Zrestartuj C64 i pokaż informacje o maszynie

BASIC程序示例 - 看 mcp_generate_basic_prg.html - 包含 Hello World，说明如何创建自己的 BASIC 二进制程序（.prg）。

🧪 测试（PL）

所有测试示例都在文件夹中 examples_http/:

测试连接:

# Pliki HTTP: test_basic_connection.http
curl http://localhost:8080/health
# Odpowiedź: "C64 Ultimate MCP Server is running"

工具列表 - 看 mcp_list_tools.http

版本 - 看

SID 集成测试 - 看 TEST_PLAY_SID_BINARY.http

PRG测试 - 看 TEST_RUN_PRG_BINARY.http

所有档案在 examples_http/mcp_*.http 符合可用的工具。

🐳 Docker（PL）

O MCP检查员

MCP检查员 这是一个用于测试和调试MCP服务器的Web工具。它提供：

交互式工具浏览
实时参数测试
查询/回复
WebSocket 监控

它会自动连接到MCP服务器，并显示所有可用的工具和详细信息。

选项 1：Docker Compose 与构建

docker compose up --build

它在本地构建映像并同时运行 MCP 服务器和 Inspector。

访问：

MCP 服务器: http://localhost:8080MCP服务器终端
MCP检查员: http://localhost:8000 - 用于测试工具的Web界面

服务范围：

mcp-server C64 Ultimate MCP服务器（支持所有工具请求）
inspector MCP Inspector（连接到 mcp-server）http://mcp-server:8080)

选项 2：Docker Compose 简单

docker compose up

运行预构建的容器（与选项1相同，但不重建映像）。

访问：

MCP 服务器: http://localhost:8080
MCP检查员: http://localhost:8000

选项3：Docker Run（预构建映像）

docker run -p 8080:8080 \
  -e ASPNETCORE_URLS=http://+:8080 \
  -e Ultimate__BaseUrl=http://192.168.0.120 \
  -d sq7mru/c64ultimatemcpserver:latest

访问：

MCP 服务器: http://localhost:8080

请注意： 此选项仅运行 MCP 服务器。若要同时运行 MCP Inspector，请使用选项 1 或 2，或运行单独的 Inspector 容器。

新标准码头公司

services:
  mcp-server:
    image: sq7mru/c64ultimatemcpserver:latest
    ports:
      - "8080:8080"
    healthcheck:
      test: ["CMD", "sh", "-c", "ps x| grep dotnet | grep C64UltimateMcpServer"]
      interval: 10s
      timeout: 5s
      retries: 10
      start_period: 10s
    environment:
      - Ultimate__BaseUrl=http://192.168.0.120
      - ASPNETCORE_URLS=http://+:8080
      - ASPNETCORE_ENVIRONMENT=Production
    networks:
      - c64-network

  mcp-inspector:
    image: mcpuse/inspector:latest
    container_name: inspector
    command:
      - /bin/sh
      - -c
      - |
        npx @mcp-use/inspector \
          --port 8000 \
        --url http://mcp-server:8080 
    ports:
      - "8000:8000"
    depends_on:
      mcp-server:
          condition: service_healthy
    networks:
      - c64-network

networks:
  c64-network:
    driver: bridge

不断变化的环境

Ultimate__BaseUrl C64 Ultimate 设备 URL （默认：http://192.168.0.120)
ASPNETCORE_URLS - 服务器绑定（默认：http://+：8080）
ASPNETCORE_ENVIRONMENT 生产/开发（Production/Development）

📚 建筑（PL）

┌─────────────────────────────────────────────┐
│         Agenci AI                           │
│  (Continue/Copilot/Cody/Cursor)             │
└──────────────────┬──────────────────────────┘
                   │ HTTP/SSE
┌──────────────────▼──────────────────────────┐
│      Serwer MCP (localhost:8080)            │
│  - Warstwa Transportu HTTP                  │
│  - Zarządzanie Sesją                        │
│  - Routing Narzędzi                         │
└──────────────────┬──────────────────────────┘
                   │ REST API
┌──────────────────▼──────────────────────────┐
│   Urządzenie C64 Ultimate                   │
│   (192.168.0.120:80)                        │
│  - V1 REST API                              │
│  - Odtwarzanie SID/MOD                      │
│  - Kontrola Stacji Dysków                   │
│  - Dostęp do Pamięci                        │
└─────────────────────────────────────────────┘

✅ 状态：准备生产（PL）

✅ 为 C64 Ultimate 操作部署了 45 种生产工具
✅ 实现了两个MCP提示符（c64_basic_program_prompt, c64_sid_music_prompt)
✅ 24 内置文档资源
✅ 在飞行中编译 BASIC 到 PRG
✅ 传输HTTP/SSE
✅ 与AI代理集成（Continue，Copilot，Cody，Cursor）
✅ MCP Inspector 中的 Docker 集装箱
✅ 没有错误和警告
✅ 完整的文档
✅ 配置管理
✅ 会话支持

解决问题（PL）

服务器没有响应

# Sprawdzenie statusu
curl http://localhost:8080/health

# Restart
taskkill /F /IM dotnet.exe  # Windows
killall dotnet              # macOS/Linux
dotnet run

无法连接到 C64 Ultimate

# Sprawdzenie dostępności
ping 192.168.0.120

# Aktualizacja konfiguracji
export Ultimate__BaseUrl=http://192.168.0.120
dotnet run

代理人看不到工具

# Sprawdzenie listy narzędzi
curl -X POST http://localhost:8080/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Sprawdzenie listy promptów
curl -X POST http://localhost:8080/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"prompts/list","params":{}}'

🎉 状态：准备生产

✅ 所有 45+ 实施的工具
✅ 在飞行中编译 BASIC 到 PRG
✅ 传输HTTP/SSE
✅ 与AI代理集成
✅ Docker 集装箱
✅ 没有错误和警告
✅ 完整的文档
✅ 配置管理
✅ 会话支持

📦 外部资源

教育资源和材料：\ 内置的 MCP 资源和 C64 指南工具基于项目文档 c64桥 作者：Chris Gleissner

23外部资源 包含：

BASIC V2 规范和示例
装配语言指南 6510
C64内存地图
规格 VIC-II， SID， CIA
Kernel API 参考（23个调用过程）
还有更多..

这些资源已被调整并集成为此服务器的 MCP 资源和指南工具。

🔗 链接

C64终极版: https://ultimate64.com/
1541 u API: https://github.com/GideonZ/1541u-documentation
c64桥: https://github.com/chrisgleissner/c64bridge/
复古64: https://retroc64.github.io/
C64U（网络巫师）: https://github.com/cybersorcerer/c64u/
C64U MCP服务器: https://github.com/xphileby/c64u-mcp-server
最终64 MCP: https://github.com/Martijn-DevRev/Ultimate64MCP
主控程序: https://modelcontextprotocol.io/
继续IDE: https://continue.dev
GitHub Copilot: https://github.com/features/copilot
科迪: https://cody.dev
光标: https://cursor.sh

📄 许可证

麻省理工学院

C64 Ultimate MCP Server

快速接入

详细介绍

C64终极MCP服务器

🎥 演示视频

⚡ 主要特点

🚀 快速开始

📦 安装

需求

设置

⚙️ 配置

应用程序参数

环境变量

码头工人

🤖 代理集成

继续IDE（推荐）

VS代码聊天（GitHub Copilot）

科迪（来源图）

光标IDE

🛠️ 工具（共45个）

机器控制（5）

项目管理（6）

内存管理（5）

音频播放（5）

驱动器管理（7）

磁盘创建（4）

ROM管理（1）

文件管理（1）

配置管理（6）

连接管理（2）

系统信息（1）

💬 提示（共14条）

�️ 总结（共45个工具）

�📚 资源（共38个）

基础资源（7）

装配资源（1）

内存资源（3）

图形资源（4）

声音资源（4）

I/O资源（2）

驱动资源（1）

打印机资源（6）

API资源（2）

📝 例子

HTTP/cURL

继续IDE

🧪 测试

🐳 Docker部署

关于MCP检查员

选项1：Docker构建

选项2：Docker编写简单

选项3:Docker运行（预构建映像）

自定义docker-compose.yml

环境变量

📚 建筑

✅ 状态：生产就绪

📦 外部资源

🔗 链接

📄 许可证

🇵🇱 C64终极MCP服务器（Polski）

🎥 Wideo演示

📋 内容列表

安装（PL）

码头工人

配置 （PL）

应用程序参数

可变环境

🛠️ 工具 （45 次）

机器控制 （5）

项目管理 （6）

记忆管理 （5）

音频播放 （5）

磁盘驱动器管理 （7）

创建磁盘 （4）

管理 ROM （1）

文件管理 （1）

配置管理 （6）

连接管理 （2）

系统信息 （1）

💬 提示 （14 次）

配置（PL）

🛠️ 工具（45 次）

机器控制（5）

项目管理（6）

记忆管理（5）

音频播放（5）

磁盘驱动器管理（7）

创建磁盘（4）

文件管理（1）

配置管理（6）

连接管理（2）

系统信息（1）

💬 提示（14 次）

装配设备（1）

记忆资源（3）

图形资源（4）

音频资源（4）

I/O 资源（2）

硬盘设备（1）

打印机设备（6）

API 资源（2）

📚 建筑（PL）

✅ 状态：准备生产（PL）

🎉 状态：准备生产