C64 Ultimate MCP Server

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 45+ tools (45 device operations), 14 MCP prompts, and 38 embedded documentation resources. Built in C# with enterprise-grade architecture, type safety, and comprehensive API coverage.

License: MIT License (see LICENSE file)

🎥 Demo Video

⚡ Key Features

• Complete Ultimate 64 API Support: All 45+ tools from the 1541U REST API
• MCP Prompts Support: 14 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: 38 embedded documentation resources (BASIC specs, Assembly guides, 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
• HTTP/SSE Transport: Remote multi-client support with session management
• 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

🚀 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)

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

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

3. 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)

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

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

3. Use:

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

Cody (Sourcegraph)

cody mcp add c64

... [View full README on GitHub](https://github.com/ch0mik/C64UltimateMcpServer#readme)