C64u MCP Server

🚀 Commodore 64 Ultimate MCP Server

AIを使ってCommodore 64 Ultimateデバイスを制御できます。このMCPサーバーにより、Claudeや他のAIアシスタントがローカルネットワークを介してC64 Ultimateハードウェアとやり取りできます。

🚀 クイックスタート

このサーバーはModel Context Protocol (MCP)を実装しており、C64 UltimateのREST APIをAIアシスタントが使用できるツールとして公開します。Claude Desktopや他のMCPクライアントに接続すると、C64に関する自然な会話ができ、Claudeがこれらのツールを使ってあなたの要求を実行します。

✨ 主な機能

何ができるか？

• プログラムの作成とデバッグ - ClaudeがC64 BASICまたはマシンコードのプログラムを作成し、実行し、画面をキャプチャして結果を確認し、メモリを調べ、問題を反復的に修正できます。あなたが望むことを説明すると、Claudeが実際のハードウェア上で開発を行います。
• BASICプログラムの作成と実行 - ClaudeにBASICプログラムを作成するように依頼すると、コードをトークン化し、直接C64のメモリに注入して実行します。タイピングは不要です。
• クラシックゲームとデモの再生 - デバイスのストレージから.PRGプログラムや.CRTカートリッジイメージを読み込んで実行するか、直接アップロードします。
• SID音楽の再生 - クラシックなC64 SID曲やAmiga MODトラッカーファイルを再生します。デバイス上のファイルを指定するか、アップロードします。
• 画面の確認 - テキスト、マルチカラー、ハイレゾビットマップなど、あらゆるグラフィックモードからスクリーンショットをキャプチャできます。Claudeが画面の状況を把握し、適切に応答します。
• 入力と制御 - キーストロークを送信し、メニューをナビゲートし、キーボードバッファを介して実行中のプログラムとやり取りします。
• フロッピードライブの管理 - D64/D71/D81ディスクイメージのマウントとアンマウント、1541/1571/1581エミュレーションモードの切り替え、新しいディスクイメージの作成を行います。
• メモリの読み書き - DMAを介してC64のメモリを直接調査および変更します。デバッグ、値の設定、またはプログラムの状態の調査に役立ちます。
• デバイスの設定 - デバイスの設定を調整し、設定をフラッシュに保存し、C64 Ultimateのセットアップを管理します。

📦 インストール

前提条件

C64 UltimateメニューからWeb Remote Control Serviceを有効にします。

• 次のパスに移動します: Network Settings → Web Remote Control Service → Enabled

インストール手順

cd c64u-mcp-server
uv sync

設定

C64U_URL環境変数をデバイスのIPアドレスに設定します。

export C64U_URL="http://192.168.200.157"

デフォルト: http://192.168.200.157

サーバーの実行

uv run python server.py

Claude Desktopの設定

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

💻 使用例

利用可能なツール

マシン制御

• machine_reset - C64をリセットします。
• machine_reboot - Ultimateデバイスを再起動します。
• machine_pause - DMAを介してCPUを一時停止します。
• machine_resume - 一時停止から再開します。
• machine_poweroff - 電源を切断します（U64のみ）。
• capture_screen - C64の画面をPNG画像としてキャプチャします。
• type_text - キーボードバッファにテキストを入力します（特殊キーをサポート）。
• send_key - キーボードバッファに特殊キーを送信します。
• enter_basic_program - BASICプログラムを直接メモリに入力します（トークン化済み）。

メモリアクセス

• write_memory - C64のメモリに16進データを書き込みます。
• write_memory_binary - メモリにバイナリデータを書き込みます（base64）。
• read_memory - C64のメモリを読み取ります。
• read_debug_register - デバッグレジスタを読み取ります（U64）。
• write_debug_register - デバッグレジスタに書き込みます（U64）。

ランナー（SID/MOD/PRG/CRT）

• sidplay_file - デバイスのファイルシステムからSIDファイルを再生します。
• sidplay_upload - SIDファイルをアップロードして再生します（base64）。
• modplay_file - デバイスのファイルシステムからMODファイルを再生します。
• modplay_upload - MODファイルをアップロードして再生します（base64）。
• load_prg_file - PRGを実行せずに読み込みます。
• load_prg_upload - PRGをアップロードして読み込みます（base64）。
• run_prg_file - ファイルシステムからPRGを読み込んで実行します。
• run_prg_upload - PRGをアップロードして実行します（base64）。
• run_crt_file - ファイルシステムからカートリッジを起動します。
• run_crt_upload - カートリッジをアップロードして起動します（base64）。

フロッピードライブ

• list_drives - すべてのドライブとマウントされたイメージをリストします。
• mount_disk_file - ファイルシステムからディスクをマウントします。
• mount_disk_upload - ディスクをアップロードしてマウントします（base64）。
• drive_reset - ドライブをリセットします。
• drive_remove - ディスクをアンマウントします。
• drive_on - ドライブを有効にします。
• drive_off - ドライブを無効にします。
• drive_load_rom_file - カスタムROMを読み込みます。
• drive_load_rom_upload - カスタムROMをアップロードします（base64）。
• drive_set_mode - ドライブのタイプを変更します（1541/1571/1581）。

設定

• list_config_categories - すべての設定カテゴリをリストします。
• get_config_category - カテゴリ内の項目を取得します。
• get_config_item - 特定の設定項目を取得します。
• set_config_item - 設定項目の値を設定します。
• batch_set_config - 複数の設定項目を設定します。
• load_config_from_flash - フラッシュから設定を復元します。
• save_config_to_flash - 設定をフラッシュに保存します。
• reset_config_to_default - 工場出荷時のデフォルト設定にリセットします。

ストリーム（U64のみ）

• stream_start - ビデオ/オーディオ/デバッグストリームを開始します。
• stream_stop - アクティブなストリームを停止します。

ファイル操作

• get_file_info - ファイルのメタデータを取得します。
• get_version - REST APIのバージョンを取得します。
• create_d64 - D64ディスクイメージを作成します。
• create_d71 - D71ディスクイメージを作成します。
• create_d81 - D81ディスクイメージを作成します。
• create_dnp - DNPディスクイメージを作成します。

📚 詳細文档

APIリファレンス

ベース: https://1541u-documentation.readthedocs.io/en/latest/api/api_calls.html