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 框架构建。