MCP Dos

🚀 MCP DOS - Classic DOS Gaming Server

A Model Context Protocol (MCP) server enabling access to classic DOS games via js - dos emulation. Play legendary games like DOOM, Super Mario, Tetris, and Duke Nukem 3D directly from your AI assistant.

🚀 Quick Start

Add this server to your MCP client configuration:

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

✨ Features

• Classic DOS Games: Play iconic DOS games including DOOM, Super Mario, Tetris, and Duke Nukem 3D.
• Web-based Emulation: Utilizes js - dos for an authentic DOS gaming experience in the browser.
• Fullscreen Support: Enjoy games in fullscreen mode with proper controls.
• Keyboard Mapping: Comes with pre - configured key mappings for each game, along with on - screen controls.
• Server Management: Offers tools to start, stop, and manage the gaming server.

🎮 Available Games

• DOOM (doom) - The legendary first - person shooter.
• Super Mario (super - mario) - A classic platformer adventure.
• Tetris (tetris) - The timeless puzzle game.
• Duke Nukem 3D (duke3d) - An action - packed FPS adventure.

💻 Usage Examples

Game Controls

Each game has pre - configured controls displayed on the screen:

DOOM

• Arrow Keys: Movement (Forward/Back/Left/Right)
• W: Use
• S: Fire
• A/D: Strafe left/right
• Enter: Menu navigation

Super Mario

• Arrow Left/Right: Movement
• Alt: Jump

Tetris

• 7/8: Move left/right
• 9: Rotate piece
• Space: Drop piece
• Enter: Menu navigation

Duke Nukem 3D

• Arrow Keys: Movement
• Ctrl: Fire
• A: Jump
• Enter: Menu navigation

Tools Available

1. List DOS Games

Lists all available DOS games that can be played through the server.

Returns:

• An array of available game slugs.
• Instructions on how to play games using the open - dos tool.

2. open - dos

Opens and plays a specific DOS game using js - dos emulation in a browser window.

Parameters:

• game (string): The DOS game slug to play (e.g., 'doom', 'super - mario', 'tetris', 'duke3d').

Features:

• Launches the game in a new browser window.
• Displays game - specific controls on the screen.
• Supports fullscreen mode.
• Provides an authentic DOS gaming experience.

3. close - app

Closes an existing running mcp - dos server instance.

Parameters:

• port (number): The port number of the server to close.

Use Cases:

• Clean up server instances.
• Resolve port conflicts.
• Perform server maintenance.

🔧 Technical Details

Development

# Install dependencies
pnpm install

# Build the project
pnpm build

# Run the server
pnpm start

Requirements

• Node.js ≥20.0.0
• A modern web browser with JavaScript enabled.
• An internet connection for js - dos CDN resources.

⚠️ Important Note This project is built using the xmcp framework.