Provides DOS game emulation through js-dos, allowing AI assistants to launch and play classic DOS games like DOOM, Super Mario, Tetris, and Duke Nukem 3D in a browser window with configurable controls.
Runs the MCP-DOS server that enables access to classic DOS games, with requirements specifying Node.js ≥20.0.0 for proper functioning.
Used for package management in the MCP-DOS project, with specific commands for installing dependencies, building, and running the server.
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 shooterSuper Mario (
super-mario
) - Classic platformer adventureTetris (
tetris
) - The timeless puzzle gameDuke Nukem 3D (
duke3d
) - Action-packed FPS adventure
Getting Started
Add this server to your MCP client configuration:
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
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.
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
- AsecurityAlicenseAqualityEnables interaction with iOS simulators by providing tools to inspect UI elements, control UI interactions, and manage simulators through natural language commands.Last updated -101,1401,060MIT License
- -securityAlicense-qualityA 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 -2MIT License
- AsecurityAlicenseAqualityA 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 -1315MIT License
- -securityAlicense-qualityEnables 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 -MIT License