XC

xphileby/c64u-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

22 stars 2 forks 품질 53 트렌드 10

MCP (모델 Context Protocol) Commodore 64 Ultimate Computer 서버.

개요

Commodore 64 Ultimate 장치를 AI로 제어하십시오. 이 MCP 서버는 Claude 및 기타 AI 조수가 로컬 네트워크에서 C64 Ultimate 하드웨어와 상호 작용합니다. - Claude는 C64 BASIC 또는 기계 부호 프로그램을 쓸 수 있고, 그(것)들을 달고, 결과를 보기 위하여 스크린을 붙잡고, 기억을 검열하고, iteratively 고침 문제점을 검사합니다. 원하는 것을 설명하고 Claude는 실제 하드웨어에서 개발합니다. - BASIC 프로그램을 작성하고 코드를 토큰화하고 C64 메모리로 직접 주사하고 실행합니다. 자주 묻는 질문 - 로드 및 실행 .PRG 프로그램 또는 .CRT 카트리지 이미지 장치의 저장 또는 직접 업로드. - 클래식 C64 SID 튜너 또는 Amiga MOD 트래커 파일을 재생합니다. 기기에 파일을 저장하거나 업로드할 수 있습니다. - 모든 그래픽 모드에서 캡처 스크린 샷 : 텍스트, 다색, 고용 비트 맵, 그리고 더. Claude는 무슨 일이 일어나고 응답 할 수 있습니다. - 키 입력, 메뉴 탐색 및 키보드 버퍼를 통해 실행 프로그램과 상호 작용합니다.

개요(AI 번역)

Commodore 64 Ultimate 장치를 AI로 제어하십시오. 이 MCP 서버는 Claude 및 기타 AI 조수가 로컬 네트워크에서 C64 Ultimate 하드웨어와 상호 작용합니다.

당신은 무엇을 할 수 있습니까?

Create and Debug Programs - Claude는 C64 BASIC 또는 Machine Code 프로그램을 작성할 수 있으며, 결과를 볼 수 있는 화면을 캡처하고 메모리를 검사하고, 이를 수정할 수 있습니다. 원하는 것을 설명하고 Claude는 실제 하드웨어에서 개발합니다.

Write and Run BASIC Programs - Ask Claude는 BASIC 프로그램을 작성하고 C64 메모리로 코드를 토큰화하고 실행합니다. 자주 묻는 질문

** Classic Games and Demos** - 로드 및 실행 .PRG 프로그램 또는 .CRT 카트리지 이미지 장치의 저장 또는 직접 업로드.

** SID Music에 나열 ** - 클래식 C64 SID 튜너 또는 Amiga MOD 트래커 파일을 재생합니다. 기기에 파일을 저장하거나 업로드할 수 있습니다.

See What’s on Screen - 모든 그래픽 모드에서 캡처 스크린 샷: 텍스트, 다색, 고용 비트 맵, 그리고 더. Claude는 무슨 일이 일어나고 응답 할 수 있습니다.

Type and Control - 키 입력을 전송하고 메뉴를 탐색하고 키보드 버퍼를 통해 실행 프로그램과 상호 작용합니다.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

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)
GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

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