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

Unity MCP Integration
quazaai
-
security
A
license
-
quality
A server that enables AI assistants to understand and interact with Unity projects in real-time, providing access to scene hierarchy, project settings, and the ability to execute code directly in the Unity Editor.
Last updated -
78
MIT License
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 -
6
737
813
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
GeoFS MCP Server
lobstercare
-
security
F
license
-
quality
A server that allows AI models to control and interact with aircraft in the GeoFS browser-based flight simulator through standardized interfaces.
Last updated -
2
JavaScript

View all related MCP servers

MCP DOS - Classic DOS Gaming Server