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-dostool
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.