C64Ultimate

БесплатноНе проверен

C64 Ultimate MCP Server

автор: ch0mik

GitHub Embed

Описание

C64 Ultimate MCP Server

README

English | Polski

⚙️ This project was built 100% using AI Agent prompts - Every line of code, configuration, and documentation was generated through conversational prompts to GitHub Copilot Agent.

Comprehensive Model Context Protocol (MCP) server for the Commodore 64 Ultimate device with 46 MCP tools, 15 MCP prompts, and 55 embedded documentation resources. Built in C# with enterprise-grade architecture, type safety, and comprehensive API coverage.

License: MIT License (see LICENSE file)

🎥 Demo Video

C64 Ultimate MCP Server Demo

⚡ Key Features

Complete Ultimate 64 API Support: 46 MCP tools covering the Ultimate REST API plus PRG generation workflows
MCP Prompts Support: 15 prompt templates exposed through prompts/list and prompts/get
BASIC to PRG Compilation: Real-time compilation of BASIC V2 source code to executable PRG files
MCP Resources: 55 embedded documentation resources (BASIC specs, Assembly guides, examples, source catalogs, Kernal API, memory maps, graphics, sound, I/O, drive, printer, keyboard/control codes, disassembly)
Separated Client Library: Reusable C64UltimateClient NuGet package with clean async API
Clean Architecture: Client → Service → MCP wrapper pattern with proper DI
Streamable HTTP Transport: Remote multi-client support with session-aware MCP interactions
Streaming Support: Video, audio, and debug streaming capabilities
Binary File Support: Upload PRG files via base64, file path, or URL
ASP.NET Core 8.0/10.0: Modern, high-performance web framework
Enterprise Configuration: appsettings.json with environment overrides
Type Safety: C# static typing with full null-safety and nullable reference types
Structured Logging: Separate loggers for client and service layers
Production-Ready: Zero errors/warnings, comprehensive error handling
Agent Integration: Works with Continue, Copilot, Cody, Cursor, Claude Desktop

🧠 Embedded Knowledge Resources

The server exposes a curated MCP resource catalog under c64://resources/index. The resources are stored in C64UltimateMcpServer/Resources/data as OKF-style markdown or plain-text assets and are wired through C64ResourceCatalog and C64ResourceProvider.

Recent additions make the resource set more useful for agents writing Commodore 64 games, demos, and hardware-aware programs:

Source provenance: c64://sources/classic-c64-references records the classic C64 books/manuals used as source material without requiring host-specific source paths.
Example routing: c64://examples/index and c64://examples/game-demo-patterns route agents to embedded examples that work with the built-in PRG generators and portable game/demo pattern notes.
Ready-to-use assembly examples: c64://examples/assembly/raster-bars-demo, c64://examples/assembly/sprite-demo, and c64://examples/assembly/joystick-game-loop provide compact, tested starting points for demos and games.
Generator-tested adaptations: c64://examples/assembly/hires-dot-burst-generator and c64://examples/assembly/dreadline-fastscroll-generator preserve source ideas from upstream C64 sources/C64AIToolChain in forms that compile through ultimate_generate_assembly_prg.
Embedded reference sources: c64://examples/assembly/hires-fire-line-demo and c64://examples/assembly/hires-line-draw-library preserve the upstream HIRES graphics demo/library inside the MCP server.
Practical coding references: c64://assembly/ml-kernal-quickstart, c64://memory/mapping-notes, expanded KERNAL API notes, and improved sprite/charset guidance help agents choose safe memory locations, KERNAL calls, and VIC-II workflows.

The embedded examples are intentionally small and aligned with the built-in BASIC/assembly PRG generators. Larger C/cc65 examples are indexed as reference material until a C compiler workflow is added.

🚀 Quick Start

# 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

📦 Installation

Requirements

.NET 10.0 SDK - Download
C64 Ultimate device - On your network
Curl or HTTP client - For testing
Docker (optional) - Download

Setup

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

⚙️ Configuration

appsettings.json

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

Environment Variable

Ultimate__BaseUrl=http://192.168.0.120

Docker

environment:
  - Ultimate__BaseUrl=http://192.168.0.120

🤖 Agent Integration

Continue IDE (Recommended)

Install Continue - https://continue.dev
Configure .continue/config.json:

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

Use in Chat:

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

VS Code Chat (GitHub Copilot)

Install - GitHub Copilot Chat extension
Configure .vscode/settings.json:

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

Use:

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

Cody (Sourcegraph)

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

Then in Cody:

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

Cursor IDE

Configure .cursor/mcp.json:

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

Use slash commands:

/c64 reboot device
/c64 load program

🛠️ Tools (46 Total)

Machine Control (5)

ultimate_reset_machine - Soft reset C64 (preserves configuration)
ultimate_reboot_device - Full device restart (reinitializes cartridge)
ultimate_pause_machine - Pause machine execution
ultimate_resume_machine - Resume machine execution
ultimate_power_off - Power off C64

Program Management (7)

ultimate_generate_basic_prg - Generate PRG from BASIC source code with token conversion
ultimate_generate_assembly_prg - Generate PRG from 6510 assembly source code
ultimate_load_program - Load PRG program from filesystem
ultimate_run_program - Load and execute PRG from disk
ultimate_run_prg_binary - Execute program from binary data, URL or file
ultimate_run_cartridge - Load and run cartridge
ultimate_menu_button - Simulate menu button press

Memory Management (5)

ultimate_read_memory - Read C64 RAM memory contents
ultimate_write_memory - Write to RAM memory
ultimate_write_memory_binary - Write binary data to memory
ultimate_get_debug_register - Read debug register
ultimate_set_debug_register - Write to debug register

Audio Playback (5)

ultimate_play_sid - Play SID file with optional song number
ultimate_play_sid_binary - Play SID from binary data, URL or file
ultimate_play_mod - Play Amiga MOD file
ultimate_start_stream - Start audio/video/debug stream
ultimate_stop_stream - Stop active stream

Drive Management (7)

ultimate_get_drives - Get information about all disk drives
ultimate_mount_disk - Mount disk image from filesystem or binary data
ultimate_unmount_disk - Unmount disk image
ultimate_reset_drive - Reset selected disk drive
ultimate_set_drive_mode - Change drive operating mode
ultimate_turn_drive_on - Power on disk drive
ultimate_turn_drive_off - Power off disk drive

Disk Creation (4)

ultimate_create_d64 - Create 1541 disk image (D64)
ultimate_create_d71 - Create 1571 disk image (D71)
ultimate_create_d81 - Create 1581 disk image (D81)
ultimate_create_dnp - Create Native Partition disk image (DNP)

ROM Management (1)

ultimate_load_drive_rom - Load custom ROM to disk drive

File Management (1)

ultimate_get_file_info - Get file information

Configuration Management (8)

ultimate_get_config_categories - Get list of available configuration categories
ultimate_get_config_category - Get all settings in a category
ultimate_get_config_item - Get single configuration value
ultimate_set_config_item - Set configuration value
ultimate_bulk_config_update - Update multiple settings at once
ultimate_save_config - Save current configuration to flash
ultimate_load_config - Load configuration from flash
ultimate_reset_config - Reset configuration to defaults

Connection Management (2)

ultimate_get_connection - Get current connection settings
ultimate_set_connection - Change device hostname/port

System Information (1)

ultimate_version - Get C64 Ultimate API version

💬 Prompts (15 Total)

basic-program - BASIC program workflow prompt
assembly-program - Assembly workflow prompt
assembly-prg-build - Assembly-to-PRG build workflow prompt
sid-music - SID composition workflow prompt
graphics-demo - VIC-II graphics demo workflow prompt
printer-job - Printer workflow prompt
memory-debug - Memory inspection / patch workflow prompt
drive-manager - Drive management workflow prompt
game-loop-basic - BASIC game loop workflow prompt
petscii-ui-layout - PETSCII UI layout workflow prompt
keyboard-input-c64 - Keyboard input workflow prompt
sprite-marker-workflow - Sprite marker workflow prompt
sid-sfx-basic - SID SFX workflow prompt
c64_basic_program_prompt - Legacy BASIC prompt template exposed as an MCP prompt
c64_sid_music_prompt - Legacy SID prompt template exposed as an MCP prompt

Important: prompts are MCP prompts, not tools.
Use prompts/list and prompts/get for prompts, and tools/call only for tools.

Summary (46 Total Tools)

Machine Control: 5 tools
Program Management: 7 tools
Memory Management: 5 tools
Audio Playback: 5 tools
Drive Management: 7 tools
Disk Creation: 4 tools
ROM Management: 1 tool
File Management: 1 tool
Configuration Management: 8 tools
Connection Management: 2 tools
System Information: 1 tool

📚 Resources (55 Total)

Embedded documentation accessible via MCP Inspector at http://localhost:8000:

BASIC Resources (9)

c64://basic/spec - BASIC V2 Language Specification
c64://basic/pitfalls - BASIC Pitfalls and Common Gotchas
c64://basic/examples/hello-world - Hello World Example
c64://basic/examples/joystick - Joystick Input Example
c64://basic/examples/bounce - Bounce Animation Example
c64://basic/examples/wave - Wave Animation Example
c64://basic/examples/entchen-petscii - PETSCII example
c64://basic/examples/games/snake - Snake example
c64://basic/examples/games/tictactoe - Tic-tac-toe example

Assembly Resources (5)

c64://assembly/spec - 6510 Assembly Language Specification
c64://assembly/tooling-notes - 6510 Assembly Tooling Notes for MCP compiler subset
c64://assembly/ml-kernal-quickstart - Machine-language KERNAL quickstart
c64://assembly/examples/hello-sys - Minimal SYS-start assembly example
c64://assembly/examples/text-scroll - VIC-II text scroller (softscroll + hardscroll) example

Memory Resources (5)

c64://memory/map - C64 Memory Map (0x0000-0xFFFF)
c64://memory/kernal - Kernal Memory Map (ROM $E000-$FFFF)
c64://memory/low - Low Memory Map (0x0000-0x03FF)
c64://memory/mapping-notes - Practical memory placement and banking notes
c64://memory/symbols - Common memory symbols

Graphics Resources (4)

c64://graphics/vic-spec - VIC-II Chip Specification
c64://graphics/charset - Character Set Reference
c64://graphics/petscii - PETSCII style guide
c64://graphics/sprite-charset-best-practices - Sprite/charset guidance

Sound Resources (4)

c64://sound/sid-spec - SID Chip specification
c64://sound/sid-programming - SID programming guide
c64://sound/sid-file-structure - SID file format documentation
c64://sound/sidwave - SIDWAVE format reference

I/O Resources (5)

c64://io/cia-spec - CIA Chip specification
c64://io/io-spec - I/O Port specification
c64://io/joystick - Joystick reference
c64://io/keyboard-c64 - Keyboard matrix reference
c64://io/control-codes-c64 - Control code reference

Drive Resources (1)

c64://drive/spec - 1541/1571/1581 Disk Drive Specification

Printer Resources (6)

c64://printer/commodore-spec - Commodore Printer Specification
c64://printer/epson-spec - Epson Printer Specification
c64://printer/spec - Unified printer guide
c64://printer/prompts - Printer prompt routing guide
c64://printer/commodore-bitmap - Commodore bitmap printing
c64://printer/epson-bitmap - Epson bitmap printing

API Resources (2)

c64://api/basic-api - BASIC callable API reference
c64://api/kernal-api - Kernal callable API reference

Example Resources (11)

c64://examples/index - Example source routing index
c64://examples/game-demo-patterns - Game and demo pattern notes
c64://examples/assembly/dreadline-fastscroll-generator - Dreadline-derived fastscroll generator example
c64://examples/assembly/raster-bars-demo - Raster bars assembly demo
c64://examples/assembly/sprite-demo - Single sprite assembly demo
c64://examples/assembly/joystick-game-loop - Joystick game loop assembly skeleton
c64://examples/assembly/hires-fire-line-demo - HIRES fire/line demo reference
c64://examples/assembly/hello-world-kernal - KERNAL hello world assembly example
c64://examples/assembly/hires-dot-burst-generator - HIRES dot burst generator example
c64://examples/assembly/hires-line-draw-library - HIRES line draw library reference
c64://examples/basic/token-control-codes - BASIC token/control-code example

Example provenance:

Resource	Origin	Notes
`c64://examples/assembly/raster-bars-demo`	C64 Ultimate MCP Server	Compact generator-tested demo written for `ultimate_generate_assembly_prg`.
`c64://examples/assembly/sprite-demo`	C64 Ultimate MCP Server	Compact generator-tested sprite setup/movement demo.
`c64://examples/assembly/joystick-game-loop`	C64 Ultimate MCP Server	Compact generator-tested joystick/game-loop skeleton.
`c64://examples/assembly/hello-world-kernal`	upstream C64 sources	Embedded adaptation of the upstream C64 assembly hello-world example for the built-in assembly PRG generator.
`c64://examples/basic/token-control-codes`	upstream C64 sources	Embedded BASIC token/control-code example for the built-in BASIC PRG generator.
`c64://examples/assembly/hires-fire-line-demo`	upstream C64 sources	Embedded reference source for the HIRES fire/line demo; kept as reference because it uses an include-style library split.
`c64://examples/assembly/hires-line-draw-library`	upstream C64 sources	Embedded reference source for the HIRES line drawing and dot-stepping library.
`c64://examples/assembly/hires-dot-burst-generator`	upstream C64 adaptation	Single-file HIRES bitmap demo adapted from the fire/line idea and verified with `ultimate_generate_assembly_prg`.
`c64://examples/assembly/dreadline-fastscroll-generator`	C64AIToolChain-derived adaptation	Dreadline fastscroll idea translated from ca65 macro style to generator-tested plain 6510 loops.
`c64://examples/game-demo-patterns`	pattern review	Portable embedded notes summarizing useful C/cc65 and assembly game/demo patterns.

Source Catalog Resources (1)

c64://sources/classic-c64-references - Classic C64 reference provenance

Disassembly Resources (2)

c64://disasm/basic-rom - BASIC ROM disassembly extract
c64://disasm/kernal-rom - KERNAL ROM disassembly extract

Access Resources via MCP Inspector:

Open http://localhost:8000 (MCP Inspector)
Click "Resources" tab
Select any resource to view its full content
Copy code examples and specifications directly

📝 Examples

HTTP/cURL

HTTP examples are available in examples_http/ and are grouped by intent. Key examples:

Reboot Device - See 91_machine_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": {}
    }
  }'

Initialize MCP session - See 01_mcp_initialize.http

Run PRG Binary - See 12_tools_run_prg_binary.http

Play SID File - See 13_tools_play_sid_binary.http

Generate Assembly PRG - See 11_tools_generate_assembly_prg.http

Generate BASIC PRG - See 10_tools_generate_basic_prg.http

HTTP examples are organized into examples_http/smoke, examples_http/e2e, and examples_http/dangerous.

List Prompts:

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": {}
  }'

Get Prompt:

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"
      }
    }
  }'

Continue 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 Program Example - See 10_tools_generate_basic_prg.http to compile BASIC source code directly to executable PRG files and create your own BASIC PRG binaries.

🧪 Testing

See examples_http/ for complete smoke/e2e/manual examples:

Test Basic Connection:

# HTTP files: examples_http/smoke/01_mcp_initialize.http and related smoke scenarios
curl http://localhost:8080/health
# Response: "C64 Ultimate MCP Server is running"

List Tools - See 02_mcp_tools_list.http

List Prompts:

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":{}}'

Get Version - See 07_ultimate_version.http

Test SID Binary Upload - See 13_tools_play_sid_binary.http

Test PRG Binary Upload - See 12_tools_run_prg_binary.http

Use examples_http/smoke for non-destructive verification, examples_http/e2e for safe manual flows, and examples_http/dangerous only for explicit state-changing operations.

When a tool reaches the Ultimate device and the device/API is unavailable, the server returns a valid MCP tools/call result with isError: true and machine-readable structuredContent instead of a protocol error. This keeps transport-level success (HTTP 200) while exposing execution failures to AI agents for self-correction.

If Ultimate__BaseUrl is unreachable, expect this split in manual E2E:

PRG generation tools (ultimate_generate_basic_prg, ultimate_generate_assembly_prg) still succeed locally.
Device-bound tools (ultimate_run_prg_binary, ultimate_play_sid_binary, disk image creation, config/machine/drive actions) return tool errors such as Connection refused (...) with isError: true.

🐳 Docker Deployment

About MCP Inspector

The MCP Inspector is a web-based tool for testing and debugging MCP servers. It provides:

Interactive tool exploration
Real-time parameter testing
Request/response inspection
WebSocket monitoring

It automatically connects to the MCP server and displays all available tools with detailed information.

Option 1: Docker Compose with Build

docker compose up --build

Builds the image locally and starts both MCP server and inspector.

This workflow has been validated locally. If image build previously failed on transient NuGet traffic, retrying docker compose up -d --build should now use the hardened restore flow from the Dockerfile.

Access:

MCP Server: http://localhost:8080 - Main MCP Server endpoint
MCP Inspector: http://localhost:8000 - Web UI for testing tools

Services:

mcp-server - C64 Ultimate MCP Server (handles all tool requests)
inspector - MCP Inspector UI (connects to mcp-server at http://mcp-server:8080)

Option 2: Docker Compose Simple

docker compose up

Starts pre-built containers (same as Option 1 but without rebuilding image).

Access:

MCP Server: http://localhost:8080
MCP Inspector: http://localhost:8000

Option 3: Docker Run (Pre-built Image)

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

Access:

MCP Server: http://localhost:8080

Note: This option runs only the MCP Server. To also run MCP Inspector, either use Option 1 or 2, or run a separate inspector container.

Custom 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

Environment Variables

Ultimate__BaseUrl - C64 Ultimate device URL (default: http://192.168.0.120)
ASPNETCORE_URLS - Server binding (default: http://+:8080)
ASPNETCORE_ENVIRONMENT - Environment mode (Production/Development)

📚 Architecture

┌─────────────────────────────────────────────┐
│         AI Agents                           │
│  (Continue/Copilot/Cody/Cursor)             │
└──────────────────┬──────────────────────────┘
                   │ Streamable HTTP
┌──────────────────▼──────────────────────────┐
│      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                            │
└─────────────────────────────────────────────┘

✅ Status: Production Ready

✅ 46 production tools implemented for C64 Ultimate operations
✅ 15 MCP prompts implemented
✅ 55 embedded documentation resources
✅ BASIC to PRG on-the-fly compilation
✅ Streamable HTTP transport
✅ Agent integration (Continue, Copilot, Cody, Cursor)
✅ Docker containerization with MCP Inspector
✅ Zero errors/warnings
✅ Comprehensive documentation
✅ Configuration management
✅ Session handling

📦 External Resources

External Resources and Learning Materials:
The embedded MCP Resources and C64 Learning Guide tools are based on documentation from the c64bridge project by Chris Gleissner.

23 Embedded External Resources include:

BASIC V2 Specification and Examples
6510 Assembly Language Guide
C64 Memory Maps
VIC-II, SID, CIA Specifications
Kernal API Reference (23 callable routines)
And more...

These external resources have been adapted and integrated as MCP Resources and Learning Guide tools for this server.

🔗 Links

C64 Ultimate: https://ultimate64.com/
1541u API: https://github.com/GideonZ/1541u-documentation
c64bridge: https://github.com/chrisgleissner/c64bridge/
RetroC64: https://retroc64.github.io/
C64U (cybersorcerer): https://github.com/cybersorcerer/c64u/
C64U MCP Server: https://github.com/xphileby/c64u-mcp-server
Ultimate64 MCP: https://github.com/Martijn-DevRev/Ultimate64MCP
MCP Spec: https://modelcontextprotocol.io/
Continue IDE: https://continue.dev
GitHub Copilot: https://github.com/features/copilot
Cody: https://cody.dev
Cursor: https://cursor.sh

📄 License

MIT

🇵🇱 C64 Ultimate MCP Server (Polski)

⚙️ Ten projekt został stworzony 100% za pomocą promptów do Agenta AI - Każda linia kodu, konfiguracji i dokumentacji została wygenerowana poprzez konwersacyjne prompty do GitHub Copilot Agent.

Kompleksowy serwer Model Context Protocol (MCP) dla urządzenia Commodore 64 Ultimate z 46 narzędziami MCP, 15 promptami MCP i 55 zasobami dokumentacyjnymi. Zbudowany w C# z architekturą klasy enterprise, bezpieczeństwem typów i kompleksowym pokryciem API.

🎥 Wideo Demo

C64 Ultimate MCP Server Demo

📋 Spis Treści

.NET 10.0 SDK - Pobierz
Urządzenie C64 Ultimate - W sieci lokalnej
cURL lub klient HTTP - Do testowania
Docker (opcjonalnie) - Pobierz

Instalacja (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

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

Konfiguracja (PL)

appsettings.json

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

Zmienna środowiska

Ultimate__BaseUrl=http://192.168.0.120

🛠️ Narzędzia (46 razem)

Kontrola Maszyny (5)

ultimate_reset_machine - Miękki reset C64 (zachowuje konfigurację)
ultimate_reboot_device - Pełny restart urządzenia (reinicjalizacja kartridża)
ultimate_pause_machine - Wstrzymanie pracy maszyny
ultimate_resume_machine - Wznowienie pracy maszyny
ultimate_power_off - Wyłączenie C64

Zarządzanie Programami (7)

ultimate_generate_basic_prg - Generowanie PRG z kodu BASIC z konwersją do tokenów
ultimate_generate_assembly_prg - Generowanie PRG z kodu asemblera 6510
ultimate_load_program - Ładowanie programu PRG z systemu plików
ultimate_run_program - Uruchomienie programu PRG z dysku
ultimate_run_prg_binary - Uruchomienie programu z danych binarnych, URL lub pliku
ultimate_run_cartridge - Uruchomienie kartridża
ultimate_menu_button - Symulacja naciśnięcia przycisku menu

Zarządzanie Pamięcią (5)

ultimate_read_memory - Odczyt zawartości pamięci RAM
ultimate_write_memory - Zapis do pamięci RAM
ultimate_write_memory_binary - Zapis danych binarnych do pamięci
ultimate_get_debug_register - Odczyt rejestru debugowania
ultimate_set_debug_register - Zapis do rejestru debugowania

Odtwarzanie Audio (5)

ultimate_play_sid - Odtwarzanie pliku SID z wskazanym numerem piosenki
ultimate_play_sid_binary - Odtwarzanie SID z danych binarnych, URL lub pliku
ultimate_play_mod - Odtwarzanie pliku MOD
ultimate_start_stream - Uruchomienie strumienia audio/wideo/debug
ultimate_stop_stream - Zatrzymanie aktywnego strumienia

Zarządzanie Stacjami Dysków (7)

ultimate_get_drives - Pobranie informacji o wszystkich stacjach dysków
ultimate_mount_disk - Zamontowanie obrazu dysku z systemu plików lub danych binarnych
ultimate_unmount_disk - Odmontowanie obrazu dysku
ultimate_reset_drive - Reset wybranej stacji dysków
ultimate_set_drive_mode - Zmiana trybu pracy stacji
ultimate_turn_drive_on - Włączenie stacji dysków
ultimate_turn_drive_off - Wyłączenie stacji dysków

Tworzenie Dysków (4)

ultimate_create_d64 - Tworzenie obrazu dysku 1541 (D64)
ultimate_create_d71 - Tworzenie obrazu dysku 1571 (D71)
ultimate_create_d81 - Tworzenie obrazu dysku 1581 (D81)
ultimate_create_dnp - Tworzenie obrazu dysku Native Partition (DNP)

Zarządzanie ROM-ami (1)

ultimate_load_drive_rom - Załadowanie niestandardowego ROM-u do stacji dysków

Zarządzanie Plikami (1)

ultimate_get_file_info - Pobranie informacji o pliku

Zarządzanie Konfiguracją (8)

ultimate_get_config_categories - Pobranie listy dostępnych kategorii konfiguracyjnych
ultimate_get_config_category - Pobranie ustawień całej kategorii
ultimate_get_config_item - Pobranie wartości pojedynczego ustawienia
ultimate_set_config_item - Zmiana wartości ustawienia
ultimate_bulk_config_update - Masowa zmiana wielu ustawień jednocześnie
ultimate_save_config - Zapisanie bieżącej konfiguracji
ultimate_load_config - Załadowanie konfiguracji
ultimate_reset_config - Przywrócenie konfiguracji domyślnej

Zarządzanie Połączeniem (2)

ultimate_get_connection - Pobranie aktualnych ustawień połączenia
ultimate_set_connection - Zmiana hosta/portu do nawiązania połączenia

Informacje Systemowe (1)

ultimate_version - Pobranie wersji C64 Ultimate

💬 Prompty (15 razem)

basic-program - Przepływ pracy dla programu BASIC
assembly-program - Przepływ pracy dla programu asemblerowego
assembly-prg-build - Budowanie PRG z kodu asemblera
sid-music - Przepływ pracy dla kompozycji SID
graphics-demo - Przepływ pracy dla dema graficznego VIC-II
printer-job - Przepływ pracy dla drukarki
memory-debug - Inspekcja i modyfikacja pamięci
drive-manager - Zarządzanie stacjami dysków
game-loop-basic - Pętla gry w BASIC
petscii-ui-layout - Projektowanie interfejsu PETSCII
keyboard-input-c64 - Obsługa wejścia z klawiatury
sprite-marker-workflow - Przepływ pracy dla znaczników sprite
sid-sfx-basic - Efekty dźwiękowe SID z BASIC
c64_basic_program_prompt - Szablon promptu do generowania programów C64 BASIC V2
c64_sid_music_prompt - Szablon promptu do tworzenia wskazówek kompozycji SID

Ważne: prompty MCP to nie narzędzia.
Używaj prompts/list i prompts/get dla promptów oraz tools/call wyłącznie dla narzędzi.

📚 Zasoby (55 razem)

Wbudowana dokumentacja dostępna w MCP Inspector pod adresem http://localhost:8000:

Zasoby BASIC (9)

c64://basic/spec - Specyfikacja języka BASIC V2
c64://basic/pitfalls - Typowe błędy i pułapki w BASIC
c64://basic/examples/hello-world - Przykład Hello World
c64://basic/examples/joystick - Przykład obsługi joysticka
c64://basic/examples/bounce - Przykład animacji odbijającej się piłki
c64://basic/examples/wave - Przykład animacji fali
c64://basic/examples/entchen-petscii - Przykład PETSCII
c64://basic/examples/games/snake - Przykład Snake
c64://basic/examples/games/tictactoe - Przykład kółko i krzyżyk

Zasoby Asemblera (5)

c64://assembly/spec - Specyfikacja języka asemblera 6510
c64://assembly/tooling-notes - Notatki narzędziowe dla kompilatora MCP 6510
c64://assembly/ml-kernal-quickstart - Szybki start machine language i KERNAL
c64://assembly/examples/hello-sys - Minimalny przykład assemblera uruchamiany przez SYS
c64://assembly/examples/text-scroll - Przykład scrollera tekstu VIC-II (softscroll + hardscroll)

Zasoby Pamięci (5)

c64://memory/map - Mapa pamięci C64 (0x0000-0xFFFF)
c64://memory/kernal - Mapa pamięci Kernal (ROM $E000-$FFFF)
c64://memory/low - Mapa pamięci niskiej (0x0000-0x03FF)
c64://memory/mapping-notes - Praktyczne notatki o rozmieszczaniu kodu i bankowaniu
c64://memory/symbols - Symbole pamięci

Zasoby Grafiki (4)

c64://graphics/vic-spec - Specyfikacja układu VIC-II
c64://graphics/charset - Referencja zestawu znaków
c64://graphics/petscii - Przewodnik stylu PETSCII
c64://graphics/sprite-charset-best-practices - Dobre praktyki sprite/charset

Zasoby Dźwięku (4)

c64://sound/sid-spec - Specyfikacja układu SID
c64://sound/sid-programming - Przewodnik programowania SID
c64://sound/sid-file-structure - Dokumentacja formatu pliku SID
c64://sound/sidwave - Referencja formatu SIDWAVE

Zasoby I/O (5)

c64://io/cia-spec - Specyfikacja układu CIA
c64://io/io-spec - Specyfikacja portów I/O
c64://io/joystick - Referencja joysticka
c64://io/keyboard-c64 - Macierz klawiatury C64
c64://io/control-codes-c64 - Kody sterujące C64

Zasoby Stacji Dysków (1)

c64://drive/spec - Specyfikacja stacji dysków 1541/1571/1581

Zasoby Drukarki (6)

c64://printer/commodore-spec - Specyfikacja drukarki Commodore
c64://printer/epson-spec - Specyfikacja drukarki Epson
c64://printer/spec - Ujednolicona specyfikacja drukarki
c64://printer/prompts - Routing promptów drukarki
c64://printer/commodore-bitmap - Druk bitmapowy Commodore
c64://printer/epson-bitmap - Druk bitmapowy Epson

Zasoby API (2)

c64://api/basic-api - Referencja API BASIC V2
c64://api/kernal-api - Referencja Kernal API

Zasoby Przykładów (11)

c64://examples/index - Indeks routingu przykładów źródłowych
c64://examples/game-demo-patterns - Notatki o wzorcach gier i dem
c64://examples/assembly/dreadline-fastscroll-generator - Przykład fastscroll pochodzący z Dreadline, dostosowany do generatora
c64://examples/assembly/raster-bars-demo - Demo raster bars w asemblerze
c64://examples/assembly/sprite-demo - Demo pojedynczego sprite'a w asemblerze
c64://examples/assembly/joystick-game-loop - Szkielet pętli gry z joystickiem
c64://examples/assembly/hires-fire-line-demo - Referencyjne demo HIRES fire/line z zewnętrznego źródła C64
c64://examples/assembly/hello-world-kernal - Przykład hello world z zewnętrznego źródła C64
c64://examples/assembly/hires-dot-burst-generator - Przykład HIRES dot burst z zewnętrznego źródła C64 dostosowany do generatora
c64://examples/assembly/hires-line-draw-library - Referencyjna biblioteka HIRES line draw z zewnętrznego źródła C64
c64://examples/basic/token-control-codes - Przykład tokenizacji BASIC z zewnętrznego źródła C64

Pochodzenie przykładów:

Zasób	Pochodzenie	Uwagi
`c64://examples/assembly/raster-bars-demo`	C64 Ultimate MCP Server	Kompaktowe demo sprawdzone przez `ultimate_generate_assembly_prg`.
`c64://examples/assembly/sprite-demo`	C64 Ultimate MCP Server	Kompaktowe demo konfiguracji i ruchu sprite'a, sprawdzone generatorem.
`c64://examples/assembly/joystick-game-loop`	C64 Ultimate MCP Server	Szkielet pętli gry z joystickiem, sprawdzony generatorem.
`c64://examples/assembly/hello-world-kernal`	zewnętrzne źródło C64	Osadzona adaptacja przykładu assembly hello-world dla wbudowanego generatora PRG.
`c64://examples/basic/token-control-codes`	zewnętrzne źródło C64	Osadzony przykład BASIC token/control-code dla wbudowanego generatora BASIC PRG.
`c64://examples/assembly/hires-fire-line-demo`	zewnętrzne źródło C64	Osadzone źródło referencyjne demo HIRES fire/line; zostaje jako reference, bo używa podziału z biblioteką include.
`c64://examples/assembly/hires-line-draw-library`	zewnętrzne źródło C64	Osadzone źródło referencyjne biblioteki HIRES line drawing i dot stepping.
`c64://examples/assembly/hires-dot-burst-generator`	adaptacja z zewnętrznego źródła C64	Jednoplikowe demo HIRES bitmap oparte na idei fire/line, sprawdzone przez `ultimate_generate_assembly_prg`.
`c64://examples/assembly/dreadline-fastscroll-generator`	adaptacja z C64AIToolChain	Pomysł fastscroll z Dreadline przepisany ze stylu ca65/macro na zwykłe pętle 6510 sprawdzone generatorem.
`c64://examples/game-demo-patterns`	przegląd wzorców	Przenośne notatki z użytecznych wzorców gier/dem w C/cc65 i assembly.

Zasoby Katalogów Źródeł (1)

c64://sources/classic-c64-references - Pochodzenie klasycznych źródeł referencyjnych C64

Zasoby Disassembly (2)

c64://disasm/basic-rom - Fragment disassemblacji BASIC ROM
c64://disasm/kernal-rom - Fragment disassemblacji KERNAL ROM

Dostęp do zasobów przez MCP Inspector:

Otwórz http://localhost:8000 (MCP Inspector)
Kliknij zakładkę "Resources"
Wybierz dowolny zasób, aby zobaczyć jego pełną zawartość
Skopiuj przykłady kodu i specyfikacje bezpośrednio

🤖 Agenci AI (PL)

Continue IDE (Polecane)

Instalacja - https://continue.dev
Konfiguracja .continue/config.json:

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

Użycie w Chacie:

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

VS Code Chat (GitHub Copilot)

Instalacja - Rozszerzenie GitHub Copilot Chat
Konfiguracja .vscode/settings.json:

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

Polecenia:

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

Cody (Sourcegraph)

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

W Cody:

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

Cursor IDE

Konfiguracja .cursor/mcp.json:

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

Polecenia slash:

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

Przykłady (PL)

cURL

Przykłady HTTP są dostępne w examples_http/ i pogrupowane według celu. Kluczowe przykłady:

Zrestartuj urządzenie - Zobacz 91_machine_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": {}
    }
  }'

Inicjalizacja sesji MCP - Zobacz 01_mcp_initialize.http

Uruchom program PRG - Zobacz 12_tools_run_prg_binary.http

Odtwarzaj muzykę SID - Zobacz 13_tools_play_sid_binary.http

Generuj PRG z ASM - Zobacz 11_tools_generate_assembly_prg.http

Generuj PRG z BASIC - Zobacz 10_tools_generate_basic_prg.http

Przykłady HTTP są uporządkowane w examples_http/smoke, examples_http/e2e i examples_http/dangerous.

Lista promptów:

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": {}
  }'

Pobranie promptu:

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
      }
    }
  }'

Continue 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

Przykład programu BASIC - Zobacz 10_tools_generate_basic_prg.http - zawiera przykład kompilacji BASIC do binarnego programu .prg.

🧪 Testowanie (PL)

Wszystkie przykłady testowe znajdują się w examples_http/:

Testuj Połączenie:

# Pliki HTTP: `examples_http/smoke/01_mcp_initialize.http` i pozostałe scenariusze smoke
curl http://localhost:8080/health
# Odpowiedź: "C64 Ultimate MCP Server is running"

Lista Narzędzi - Zobacz 02_mcp_tools_list.http

Wersja - Zobacz 07_ultimate_version.http

Test Wgrywania SID - Zobacz 13_tools_play_sid_binary.http

Test Wgrywania PRG - Zobacz 12_tools_run_prg_binary.http

Używaj examples_http/smoke do bezpiecznej weryfikacji, examples_http/e2e do ręcznych przepływów safe E2E, a examples_http/dangerous tylko do operacji zmieniających stan urządzenia.

Gdy narzędzie dochodzi do urządzenia Ultimate, ale samo urządzenie lub jego API jest niedostępne, serwer zwraca poprawny wynik MCP tools/call z isError: true oraz maszynowo czytelnym structuredContent, zamiast błędu protokołu. Dzięki temu transport pozostaje poprawny (HTTP 200), a agent AI widzi rzeczywisty błąd wykonania.

Jeżeli Ultimate__BaseUrl jest nieosiągalny, w ręcznych E2E oczekiwany jest taki podział:

narzędzia generujące PRG lokalnie (ultimate_generate_basic_prg, ultimate_generate_assembly_prg) przechodzą poprawnie;
narzędzia zależne od urządzenia (ultimate_run_prg_binary, ultimate_play_sid_binary, tworzenie obrazów dysków, operacje config/machine/drive) zwracają błąd toola, np. Connection refused (...), z isError: true.

🐳 Wdrażanie Docker (PL)

O MCP Inspector

MCP Inspector to narzędzie webowe do testowania i debugowania serwerów MCP. Zapewnia:

Interaktywne przeglądanie narzędzi
Testowanie parametrów w czasie rzeczywistym
Inspekcję żądań/odpowiedzi
Monitorowanie WebSocket

Automatycznie łączy się z serwerem MCP i wyświetla wszystkie dostępne narzędzia z szczegółowymi informacjami.

Opcja 1: Docker Compose z Budowaniem

docker compose up --build

Buduje obraz lokalnie i uruchamia zarówno serwer MCP jak i inspector.

Ten przebieg został już lokalnie zweryfikowany. Jeżeli build obrazu wcześniej zatrzymywał się na chwilowych problemach z NuGet, ponowne docker compose up -d --build powinno skorzystać z utwardzonego restore w Dockerfile.

Dostęp:

Serwer MCP: http://localhost:8080 - Główny punkt końcowy MCP Server
MCP Inspector: http://localhost:8000 - Interfejs webowy do testowania narzędzi

Usługi:

mcp-server - Serwer C64 Ultimate MCP (obsługuje wszystkie żądania narzędzi)
inspector - Interfejs MCP Inspector (łączy się z mcp-server pod adresem http://mcp-server:8080)

Opcja 2: Docker Compose Prosta

docker compose up

Uruchamia wstępnie zbudowane kontenery (to samo co Opcja 1, ale bez przebudowywania obrazu).

Dostęp:

Serwer MCP: http://localhost:8080
MCP Inspector: http://localhost:8000

Opcja 3: Docker Run (Wstępnie Zbudowany Obraz)

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

Dostęp:

Serwer MCP: http://localhost:8080

Uwaga: Ta opcja uruchamia tylko Serwer MCP. Aby uruchomić również MCP Inspector, użyj Opcji 1 lub 2, lub uruchom oddzielny kontener inspectora.

Niestandardowy 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

Zmienne Środowiska

Ultimate__BaseUrl - URL urządzenia C64 Ultimate (domyślnie: http://192.168.0.120)
ASPNETCORE_URLS - Wiązanie serwera (domyślnie: http://+:8080)
ASPNETCORE_ENVIRONMENT - Tryb środowiska (Production/Development)

📚 Architektura (PL)

┌─────────────────────────────────────────────┐
│         Agenci AI                           │
│  (Continue/Copilot/Cody/Cursor)             │
└──────────────────┬──────────────────────────┘
                   │ Streamable HTTP
┌──────────────────▼──────────────────────────┐
│      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                        │
└─────────────────────────────────────────────┘

✅ Status: Gotowy do Produkcji (PL)

✅ Zaimplementowano 46 narzędzi produkcyjnych dla operacji C64 Ultimate
✅ Zaimplementowano 15 promptów MCP
✅ 55 wbudowanych zasobów dokumentacyjnych
✅ Kompilacja BASIC do PRG w locie
✅ Transport Streamable HTTP
✅ Integracja z agentami AI (Continue, Copilot, Cody, Cursor)
✅ Konteneryzacja Docker z MCP Inspector
✅ Brak błędów i ostrzeżeń
✅ Pełna dokumentacja
✅ Zarządzanie konfiguracją
✅ Obsługa sesji

Rozwiązywanie Problemów (PL)

Serwer nie odpowiada

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

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

Nie mogę połączyć się z C64 Ultimate

# Sprawdzenie dostępności
ping 192.168.0.120

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

Agent nie widzi narzędzi

# 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":{}}'

🎉 Status: Gotowy do Produkcji

✅ Wszystkie 46 narzędzi zaimplementowane
✅ Kompilacja BASIC do PRG w locie
✅ Transport Streamable HTTP
✅ Integracja z agentami AI
✅ Konteneryzacja Docker
✅ Brak błędów i ostrzeżeń
✅ Pełna dokumentacja
✅ Zarządzanie konfiguracją
✅ Obsługa sesji

📦 Zasoby Zewnętrzne

Zasoby i Materiały Edukacyjne:
Wbudowane MCP Resources i narzędzia przewodników C64 są oparte na dokumentacji z projektu c64bridge autorstwa Chrisa Gleissnera.

23 Wbudowane Zasoby Zewnętrzne zawierają:

Specyfikację BASIC V2 i przykłady
Przewodnik języka asemblera 6510
Mapy pamięci C64
Specyfikacje VIC-II, SID, CIA
Referencję Kernal API (23 procedury do wywoływania)
I wiele więcej...

Zasoby te zostały zaadaptowane i zintegrowane jako MCP Resources i narzędzia przewodników dla tego serwera.

🔗 Linki

C64 Ultimate: https://ultimate64.com/
1541u API: https://github.com/GideonZ/1541u-documentation
c64bridge: https://github.com/chrisgleissner/c64bridge/
RetroC64: https://retroc64.github.io/
C64U (cybersorcerer): https://github.com/cybersorcerer/c64u/
C64U MCP Server: https://github.com/xphileby/c64u-mcp-server
Ultimate64 MCP: https://github.com/Martijn-DevRev/Ultimate64MCP
MCP: https://modelcontextprotocol.io/
Continue IDE: https://continue.dev
GitHub Copilot: https://github.com/features/copilot
Cody: https://cody.dev
Cursor: https://cursor.sh

📄 Licencja

MIT

from github.com/ch0mik/C64UltimateMcpServer

Установка C64Ultimate

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/ch0mik/C64UltimateMcpServer

FAQ

C64Ultimate MCP бесплатный?

Да, C64Ultimate MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для C64Ultimate?

Нет, C64Ultimate работает без API-ключей и переменных окружения.

C64Ultimate — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить C64Ultimate в Claude Desktop, Claude Code или Cursor?

Открой C64Ultimate на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Compare C64Ultimate with

C64UltimatevsGitHub C64UltimatevsFilesystem C64UltimatevsMemory C64UltimatevsTemplate MCP Server

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории development

Command Palette

C64Ultimate

Описание

README

🎥 Demo Video

⚡ Key Features

🧠 Embedded Knowledge Resources

🚀 Quick Start

📦 Installation

Requirements

Setup

⚙️ Configuration

appsettings.json

Environment Variable

Docker

🤖 Agent Integration

Continue IDE (Recommended)

VS Code Chat (GitHub Copilot)

Cody (Sourcegraph)

Cursor IDE

🛠️ Tools (46 Total)

Machine Control (5)

Program Management (7)

Memory Management (5)

Audio Playback (5)

Drive Management (7)

Disk Creation (4)

ROM Management (1)

File Management (1)

Configuration Management (8)

Connection Management (2)

System Information (1)

💬 Prompts (15 Total)

Summary (46 Total Tools)

📚 Resources (55 Total)

BASIC Resources (9)

Assembly Resources (5)

Memory Resources (5)

Graphics Resources (4)

Sound Resources (4)

I/O Resources (5)

Drive Resources (1)

Printer Resources (6)

API Resources (2)

Example Resources (11)

Source Catalog Resources (1)

Disassembly Resources (2)

📝 Examples

HTTP/cURL

Continue IDE

🧪 Testing

🐳 Docker Deployment

About MCP Inspector

Option 1: Docker Compose with Build

Option 2: Docker Compose Simple

Option 3: Docker Run (Pre-built Image)

Custom docker-compose.yml

Environment Variables

📚 Architecture

✅ Status: Production Ready

📦 External Resources

🔗 Links

📄 License

🇵🇱 C64 Ultimate MCP Server (Polski)

🎥 Wideo Demo

📋 Spis Treści

Instalacja (PL)

Docker

Konfiguracja (PL)

appsettings.json

Zmienna środowiska

🛠️ Narzędzia (46 razem)

Kontrola Maszyny (5)

Zarządzanie Programami (7)

Zarządzanie Pamięcią (5)

Odtwarzanie Audio (5)

Zarządzanie Stacjami Dysków (7)

Tworzenie Dysków (4)

Zarządzanie ROM-ami (1)

Zarządzanie Plikami (1)