MCP Apps Arcade

🚀 アーケードサーバのサンプル

MCP対応のホスト上で、archive.org からクラシックなアーケードゲームを閲覧して直接プレイできるMCPアプリサーバです。

📄 法律上の免責事項

これは技術的なデモンストレーションであり、配布プラットフォームではありません。

• ゲームは実行時にarchive.orgの埋め込みシステムから直接取得されます。
• 当社はゲームコンテンツをホスト、配布、または保存していません。
• 配布権が検証されたゲームのみが読み込まれます。
• 権利が検証されていないゲームはブロックされます。

権利検証の仕組み

サーバは厳格な検証システムを使用しています。

1. 精選された許可リスト： に記載されているゲームは、ソースURL（出版社の発表、公式ウェブサイト）を伴う外部文書化された配布権を持っています。各エントリには法的根拠が含まれています。
2. メタデータ検証：許可リストにないゲームについては、archive.orgのメタデータをチェックして、明示的な権利指標（シェアウェア、フリーウェア、パブリックドメイン、クリエイティブ・コモンズ）を確認します。

ゲームは権利が検証された場合にのみ許可されます。 不明または制限されたゲームはブロックされます。

利用可能なゲームはどれですか？

• シェアウェア：無料配布のために明示的にリリースされた最初のエピソード/デモ（DOOM、Duke Nukem、Commander Keen、Wolfenstein 3Dなど）
• フリーウェア：出版社によって公式に無料でリリースされたゲーム（Tyrian 2000、Jill of the Jungle）
• パブリックドメイン：著作権が失効または放棄されたゲーム

法的文書付きの完全なリストについては、 を参照してください。

エミュレータランタイム

Archive.orgは、ブラウザでゲームを実行するために Emularity システムを使用しています。これには以下が含まれます。

これらのエミュレータとの関係

• 当社はエミュレータコードを配布、バンドル、または変更していません。
• エミュレータは実行時にarchive.orgから直接取得されます。
• 当社はarchive.orgの埋め込みシステムをプロキシするだけで、このシステムが独自のエミュレータのコピーをホストしています。
• 一時的なメモリ内キャッシュ（以下を参照）は、純粋にCORS回避の目的で行われています。

ライセンス互換性について

MCPアプリSDKはApache-2.0ライセンスです。以下の理由からライセンスの競合はありません。

1. アーケードサーバはGPLエミュレータコードをバンドル、含め、またはリンクしていません。
2. エミュレータは実行時にarchive.orgから取得されます（CDNリソースを読み込むのと同じように）。
3. エミュレータはユーザのブラウザで実行され、別の実行コンテキストとなります。
4. これはYouTube動画を埋め込むのと同じで、埋め込みページはYouTubeのプレーヤーの派生品ではありません。

エミュレータコードを配布にバンドルする修正版を作成する場合は、GPL-2.0+の条項（コピーレフト、ソースコードの公開）に準拠する必要があります。

スクリプトの再ホスティング（CORS回避）

サーバは、サンドボックス化されたiframeのブラウザセキュリティ制限を回避するために、archive.orgの emulation.min.js スクリプトをメモリ内に一時的にキャッシュします（ディスクに保存されません）。これは技術的な必要性であり、再配布ではありません。

• キャッシュは Cache-Control: no-store ヘッダーを使用します。
• サーバの再起動時にキャッシュはクリアされます。
• 最初のリクエスト時にarchive.orgから新しいスクリプトが取得されます。
• iframe互換性のために import() を loadScript() に置き換える以外の変更は行われません。

新しいゲームの追加

許可リストにゲームを追加するには、以下を提供する必要があります。

1. sourceUrl：配布権を文書化した信頼できるソースへのリンク（出版社のウェブサイト、プレスリリース、公式発表）
2. legalBasis：ゲームが合法的に配布可能な理由の明確な説明
3. 検証：archive.orgの識別子が機能することを確認

疑問がある場合は、ゲームを追加しないでください。

概要

このサンプルは、MCPアプリリソースとして外部HTMLコンテンツを提供する方法を示しています。このリソースは、MCPアプリプロトコルを使用してツール引数を受け取り、サーバエンドポイントから処理済みのゲームHTMLを取得する静的ローダーです。このパターンにより、同じリソースがツール入力に基づいて異なるゲームを表示できます。

主要な技術：

• MCPアプリプロトコルのハンドシェイク（ui/initialize → ui/notifications/tool-input）を使用してゲームIDを動的に受け取る
• ゲームIDごとにサーバ側でHTMLを取得して処理する
• <base href> タグを使用して、相対URLをarchive.orgに対して解決する
• baseUriDomains CSPメタデータを使用して、<base> タグを許可する
• ESモジュールの import() を従来の <script src> ロードに書き換える（srcdoc iframe互換性のため）
• サンドボックス化されたiframeのCORS制限を回避するためのローカルスクリプトエンドポイント
• 権利チェックを行って、ゲームをロードする前に配布許可を検証する

主要なファイル

• - ツールとリソースの登録を行うMCPサーバ
• - HTTPトランスポートとExpressの設定
• - archive.orgのHTMLを取得して処理する
• - スマートなフォールバックと権利フィルタリングを備えたarchive.org検索
• - 配布権のためにarchive.orgのメタデータを分析する
• - 検証済みのシェアウェア/フリーウェアゲームの精選リスト
• - 権利管理のための型定義

🚀 クイックスタート

npm install
npm run dev

サーバはデフォルトで http://localhost:3002/mcp で起動します。PORT 環境変数を設定することで変更できます。

MCPクライアントの設定

{
  "mcpServers": {
    "arcade": {
      "url": "http://localhost:3002/mcp"
    }
  }
}

ツール

search_gamesのパラメータ

get_game_by_idのパラメータ

仕組み

1. ホストがsearch_gamesを呼び出す → サーバが許可リストとarchive.orgを検索する → 検証済みのゲームのみを返す
2. ホストがget_game_by_idを呼び出す → サーバが権利状況を検証する
3. 権利が検証された場合 → ツールは成功を返す
4. 権利が検証されない場合 → ツールはエラーを返し、ゲームはブロックされる
5. ホストがリソースを読み取る → MCPアプリプロトコルハンドラを持つ静的ローダーを取得する
6. ビューがホストとui/initializeハンドシェイクを実行する
7. ホストがgameIdを含むtool-inputを送信する → ビューが /game-html/:gameId を取得する
8. サーバがarchive.orgから埋め込みHTMLを取得して処理する:
   - archive.orgの <base> タグを削除する
   - URL解決のために <base href="https://archive.org/"> を挿入する
   - ESモジュールの import() を <script src> ロードに書き換える
   - emulation.min.js を取得し、パッチを適用し、ローカルエンドポイントから提供する
   - 全画面表示用のレイアウトCSSを挿入する
9. ゲームが実行される: エミュレータがROMをロードし、MAMEを初期化し、ゲームがプレイ可能になる

なぜ処理が必要なのですか？

Archive.orgのゲーム埋め込みページは、エミュレーションエンジンをロードするためにESモジュールの import() を使用しています。MCPホストで使用される srcdoc iframeでは、iframeのオリジンが null であるため、import() は失敗します。サーバは以下の方法でこの問題を回避しています。

1. サーバ側で emulation.min.js を取得 し、import() を window.loadScript() に置き換える
2. 修正されたスクリプトを ローカルのExpressエンドポイント (/scripts/emulation.js) から提供する
3. <script src> を使用する ことで、fetch() や import() とは異なり、CORS制限の影響を受けない

利用可能なゲーム (18の検証済みタイトル)

すべてのゲームは配布権が検証されています。法的文書については、 を参照してください。

id Softwareのシェアウェア

Apogee / 3D Realmsのシェアウェア

Epic MegaGamesのシェアウェア/フリーウェア