MCP DOS - Classic DOS Gaming Server

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

Features

• Classic DOS Games: Play iconic DOS games including DOOM, Super Mario, Tetris, and Duke Nukem 3D

• Web-based Emulation: Uses js-dos for authentic DOS gaming experience in the browser

• Fullscreen Support: Enjoy games in fullscreen mode with proper controls

• Keyboard Mapping: Pre-configured key mappings for each game with on-screen controls

• Server Management: Tools to start, stop, and manage the gaming server

Related MCP server: MCP Serve

Available Games

• DOOM (doom) - The legendary first-person shooter

• Super Mario (super-mario) - Classic platformer adventure

• Tetris (tetris) - The timeless puzzle game

• Duke Nukem 3D (duke3d) - Action-packed FPS adventure

Getting Started

Add this server to your MCP client configuration:

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

Game Controls

Each game comes with pre-configured controls displayed on 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:

• 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): DOS game slug to play (e.g., 'doom', 'super-mario', 'tetris', 'duke3d')

Features:

• Launches game in a new browser window

• Displays game-specific controls on screen

• Fullscreen support

• 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

• Server maintenance

Development

# Install dependencies
pnpm install

# Build the project
pnpm build

# Run the server
pnpm start

Requirements

• Node.js ≥20.0.0

• Modern web browser with JavaScript enabled

• Internet connection for js-dos CDN resources

This project is built using the xmcp framework.