MCP Dos

🚀 MCP DOS - 經典DOS遊戲服務器

MCP DOS是一個基於Model Context Protocol (MCP)的服務器，藉助js-dos模擬器，讓你能直接通過AI助手暢玩經典DOS遊戲。你可以在這裡體驗像《毀滅戰士》《超級馬里奧》《俄羅斯方塊》和《毀滅公爵3D》等傳奇遊戲。

🚀 快速開始

將此服務器添加到你的MCP客戶端配置中：

{
  "mcpServers": {
    "mcp-dos": {
      "command": "npx",
      "args": ["-y", "mcp-dos"]
    }
  }
}

✨ 主要特性

• 經典DOS遊戲：可暢玩包括《毀滅戰士》《超級馬里奧》《俄羅斯方塊》和《毀滅公爵3D》等標誌性的DOS遊戲。
• 基於網頁的模擬：使用js-dos在瀏覽器中提供真實的DOS遊戲體驗。
• 全屏支持：支持全屏模式，並配備合適的控制方式。
• 鍵盤映射：為每個遊戲預先配置了按鍵映射，並提供屏幕上的控制提示。
• 服務器管理：具備啟動、停止和管理遊戲服務器的工具。

🎮 可用遊戲

• 《毀滅戰士》 (doom) - 傳奇的第一人稱射擊遊戲。
• 《超級馬里奧》 (super-mario) - 經典的平臺冒險遊戲。
• 《俄羅斯方塊》 (tetris) - 永恆的益智遊戲。
• 《毀滅公爵3D》 (duke3d) - 充滿動作元素的第一人稱射擊冒險遊戲。

💻 使用示例

遊戲控制

每個遊戲都有預先配置好的屏幕顯示控制：

《毀滅戰士》

• 方向鍵：移動（前/後/左/右）
• W：使用
• S：射擊
• A/D：左右橫移
• Enter：菜單導航

《超級馬里奧》

• 左/右方向鍵：移動
• Alt：跳躍

《俄羅斯方塊》

• 7/8：左右移動
• 9：旋轉方塊
• Space：放下方塊
• Enter：菜單導航

《毀滅公爵3D》

• 方向鍵：移動
• Ctrl：射擊
• A：跳躍
• Enter：菜單導航

可用工具

1. List DOS Games

列出所有可通過服務器遊玩的DOS遊戲。 返回內容：

• 可用遊戲的縮寫數組
• 關於如何使用 open-dos 工具玩遊戲的說明

2. open-dos

使用js-dos模擬器在瀏覽器窗口中打開並遊玩特定的DOS遊戲。 參數：

• game（字符串）：要遊玩的DOS遊戲縮寫（例如，'doom'、'super-mario'、'tetris'、'duke3d'） 特性：
• 在新的瀏覽器窗口中啟動遊戲
• 在屏幕上顯示特定遊戲的控制方式
• 支持全屏模式
• 提供真實的DOS遊戲體驗

3. close-app

關閉現有的正在運行的mcp-dos服務器實例。 參數：

• port（數字）：要關閉的服務器的端口號 使用場景：
• 清理服務器實例
• 解決端口衝突
• 服務器維護

🛠️ 開發

# 安裝依賴
pnpm install

# 構建項目
pnpm build

# 運行服務器
pnpm start

📋 要求

• Node.js ≥20.0.0
• 啟用JavaScript的現代網頁瀏覽器
• 連接互聯網以獲取js-dos CDN資源

本項目使用 xmcp 框架構建。