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

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.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

Tools

Provides access to classic DOS games like DOOM, Super Mario, Tetris, and Duke Nukem 3D through js-dos emulation, allowing users to play these legendary games directly from their AI assistant.

Related MCP Servers

iOS Simulator MCP
joshuayoes
A
security
A
license
A
quality
Enables interaction with iOS simulators by providing tools to inspect UI elements, control UI interactions, and manage simulators through natural language commands.
Last updated -
10
1,675
906
JavaScript
MIT License
MCP Serve
mark-oori
-
security
A
license
-
quality
A server tool for running Deep Learning models that offers Shell execution, Ngrok connectivity, and Docker container hosting with support for multiple AI frameworks including Anthropic, Gemini, and OpenAI.
Last updated -
2
Python
MIT License
MCP GameBoy Server
mario-andreschak
A
security
A
license
A
quality
A Model Context Protocol server that enables LLMs to interact with a GameBoy emulator, providing tools for controlling the GameBoy, loading ROMs, and retrieving screen frames.
Last updated -
13
11
TypeScript
MIT License
Jokes MCP Server
muriloruiz91-maker
-
security
A
license
-
quality
Enables users to fetch jokes from multiple sources including Chuck Norris jokes, Dad jokes, and Yo Mama jokes through APIs. Integrates with Microsoft Copilot Studio to provide humor-focused AI agent capabilities.
Last updated -
TypeScript
MIT License

View all related MCP servers