MCP Apps Arcade

🚀 示例：街機服務器

這是一個 MCP Apps 服務器，可讓你在支持 MCP 的主機中直接瀏覽並遊玩來自 archive.org 的經典街機遊戲。

🚀 快速開始

npm install
npm run dev

服務器默認在 http://localhost:3002/mcp 啟動。你可以通過設置 PORT 環境變量來更改端口。

MCP 客戶端配置

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

✨ 主要特性

• 可在 MCP 主機中直接瀏覽和遊玩來自 archive.org 的經典街機遊戲。
• 採用嚴格的遊戲版權驗證系統，僅允許加載有合法分發權的遊戲。
• 利用服務器端處理繞過瀏覽器安全限制，確保遊戲正常加載。

📦 安裝指南

npm install
npm run dev

💻 使用示例

基礎用法

啟動服務器：

npm install
npm run dev

高級用法

若要更改服務器端口，可設置 PORT 環境變量：

PORT=3003 npm run dev

📚 詳細文檔

法律聲明

這是一個技術演示，並非分發平臺。

• 遊戲在運行時直接從 archive.org 的嵌入系統獲取。
• 我們不託管、分發或存儲遊戲內容。
• 僅允許加載具有合法分發權的遊戲。
• 無合法分發權的遊戲將被阻止。

版權驗證機制

服務器採用嚴格的驗證系統：

1. 精選白名單： 中的遊戲具有外部記錄的分發權，包含來源 URL（發行商公告、官方網站），每個條目都有法律依據。
2. 元數據驗證：對於不在白名單中的遊戲，我們會檢查 archive.org 的元數據，以確定是否有明確的版權指標（共享軟件、免費軟件、公共領域、知識共享許可）。

只有具有合法版權的遊戲才被允許加載，未知或受限的遊戲將被阻止。

可用遊戲類型

• 共享軟件：明確免費發佈的第一集/演示版遊戲（如《毀滅戰士》《毀滅公爵》《指揮官基恩》《德軍總部 3D》等）。
• 免費軟件：由發行商正式免費發佈的遊戲（如《泰瑞安 2000》《叢林女孩吉爾》）。
• 公共領域：版權已過期或被放棄的遊戲。

完整的遊戲列表及法律文檔請見 。

模擬器運行時

archive.org 使用 Emularity 系統在瀏覽器中運行遊戲，包括：

我們與這些模擬器的關係：

• 我們不分發、捆綁或修改任何模擬器代碼。
• 模擬器在運行時直接從 archive.org 獲取。
• 我們僅代理 archive.org 的嵌入系統，該系統託管了這些模擬器的副本。
• 臨時內存緩存（見下文）僅用於解決 CORS 問題。

許可證兼容性說明： MCP Apps SDK 採用 Apache - 2.0 許可證，不存在許可證衝突，原因如下：

1. 街機服務器不捆綁、包含或鏈接 GPL 模擬器代碼。
2. 模擬器在運行時從 archive.org 獲取（類似於加載任何 CDN 資源）。
3. 模擬器在用戶瀏覽器中執行，是一個獨立的執行上下文。
4. 這類似於嵌入 YouTube 視頻，嵌入頁面並非 YouTube 播放器的衍生作品。

如果你創建了一個修改版本並捆綁了模擬器代碼到分發版本中，則必須遵守 GPL - 2.0+ 條款（版權共享、源代碼可用性）。

腳本重新託管（CORS 解決方案）

服務器僅在內存中臨時緩存 archive.org 的 emulation.min.js 腳本（不持久化到磁盤），以繞過沙盒 iframe 中的瀏覽器安全限制。這是技術上的必要操作，並非重新分發：

• 緩存使用 Cache - Control: no - store 頭。
• 服務器重啟時緩存將被清除。
• 首次請求時從 archive.org 重新獲取腳本。
• 除了將 import() 替換為 loadScript() 以實現 iframe 兼容性外，不做其他修改。

添加新遊戲

若要將遊戲添加到白名單，你必須提供：

1. sourceUrl：指向記錄分發權的權威來源的鏈接（發行商網站、新聞稿、官方公告）。
2. legalBasis：明確說明遊戲合法分發的原因。
3. 驗證：確認 archive.org 標識符可用。

如有疑問，請勿添加該遊戲。

概述

此示例展示了將外部 HTML 內容作為 MCP App 資源進行服務。該資源是一個靜態加載器，使用 MCP Apps 協議接收工具參數，然後從服務器端點獲取處理後的遊戲 HTML。這種模式允許同一資源根據工具輸入顯示不同的遊戲。

關鍵技術：

• MCP Apps 協議握手（ui/initialize → ui/notifications/tool - input）以動態接收遊戲 ID。
• 服務器端根據遊戲 ID 獲取和處理 HTML。
• <base href> 標籤用於解析相對於 archive.org 的相對 URL。
• baseUriDomains CSP 元數據以允許使用 <base> 標籤。
• 將 ES 模塊 import() 重寫為經典的 <script src> 加載方式（以實現 srcdoc iframe 兼容性）。
• 本地腳本端點以繞過沙盒 iframe 中的 CORS 限制。
• 版權檢查：在加載遊戲前驗證分發權限。

關鍵文件

• - 帶有工具和資源註冊的 MCP 服務器。
• - HTTP 傳輸和 Express 設置。
• [game - processor.ts](game - processor.ts) - 獲取和處理 archive.org 的 HTML。
• - 帶有智能回退和版權過濾的 archive.org 搜索。
• [rights - checker.ts](rights - checker.ts) - 分析 archive.org 元數據以確定分發權限。
• - 精選的經過驗證的共享軟件/免費軟件遊戲列表。
• - 版權管理的類型定義。

工具

search_games 參數

get_game_by_id 參數

工作原理

1. 主機調用 search_games → 服務器搜索白名單和 archive.org → 僅返回經過驗證的遊戲。
2. 主機調用 get_game_by_id → 服務器驗證版權狀態。
3. 如果版權驗證通過 → 工具返回成功。
4. 如果版權未驗證通過 → 工具返回錯誤，遊戲被阻止。
5. 主機讀取資源 → 獲取包含 MCP Apps 協議處理程序的靜態加載器。
6. 視圖與主機執行 ui/initialize 握手。
7. 主機發送包含 gameId 的 tool - input → 視圖獲取 /game - html/:gameId。
8. 服務器從 archive.org 獲取嵌入 HTML 並進行處理：
   - 移除 archive.org 的 <base> 標籤。
   - 插入 <base href="https://archive.org/"> 以進行 URL 解析。
   - 將 ES 模塊 import() 重寫為 <script src> 加載方式。
   - 獲取 emulation.min.js，進行修補，並從本地端點提供服務。
   - 插入佈局 CSS 以實現全視口顯示。
9. 遊戲運行：模擬器加載 ROM，初始化 MAME，遊戲可玩。

為什麼要進行處理？

archive.org 的遊戲嵌入頁面使用 ES 模塊 import() 來加載仿真引擎。在 srcdoc iframe（由 MCP 主機使用）中，import() 會失敗，因為 iframe 的源為 null。服務器通過以下方式解決此問題：

1. 服務器端獲取 emulation.min.js 並將 import() 替換為 window.loadScript()。
2. 從本地 Express 端點（/scripts/emulation.js）提供修補後的腳本。
3. 使用 <script src>，它不受 CORS 限制，不像 fetch() 或 import()。

可用遊戲（18 款經過驗證的遊戲）

所有遊戲都具有經過驗證的分發權。完整的法律文檔請見 。

id Software 共享軟件

Apogee / 3D Realms 共享軟件

Epic MegaGames 共享軟件/免費軟件