MCP DOS - Classic DOS Gaming Server
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.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP DOS - Classic DOS Gaming Server open doom"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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: Flappy Bird MCP App
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:
{
"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 startRequirements
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.
Available Tools
3 toolsclose-appARead-onlyDestructiveIdempotent
Close an existing running mcp-dos server. You can use this tool if you are getting erros when starting a new server.
Inputs: port (required).
List DOS GamesBRead-onlyIdempotent
List all available DOS games
Inputs: no named parameters.
open-dosARead-onlyIdempotent
Open and play a DOS game using js-dos. Use list to see the exact key you need to use and the available games.
Inputs: game (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: close-app manages server lifecycle, List DOS Games provides a catalog, and open-dos launches a specific game. There is no overlap in functionality, and the descriptions clearly differentiate their roles.
The naming is inconsistent with mixed conventions: close-app uses kebab-case, List DOS Games uses title case with spaces, and open-dos uses kebab-case. There is no uniform verb_noun pattern, and the styles vary significantly across tools.
With only 3 tools, the count is borderline for a gaming server scope. It covers core operations (list, open, close), but feels thin compared to typical gaming servers that might include more features like save/load, settings, or game management. However, it is functional for basic play.
The tool set covers the essential lifecycle: list games, open a game, and close the server. Minor gaps exist, such as no tools for saving game progress, adjusting settings, or managing multiple sessions, but agents can perform basic gaming workflows without dead ends.
Maintenance
Related MCP Connectors
Publish, play-test and fix HTML5 browser games from your AI assistant. Own address, 70% ad share.
Publish, test and share browser games on PlayDrop from your AI agent.
Free, ad-free open-source browser games that open and play right inside the chat.
Games for AI agents. Each game runs inside a single context window.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables playing AI-generated text-based maze adventure games with synthwave themes. Create custom game worlds from any theme or URL, explore locations, collect items, and compete on leaderboards through natural language commands.6-
- FlicenseNot gradedqualityDmaintenanceProvides a fully playable Flappy Bird game that runs inline within AI chat clients. It enables users to launch the game, submit scores, and track session high scores using Model Context Protocol tools.2-
- AlicenseCqualityBmaintenanceEnables AI assistants to interact with the Zandronum game engine for development, including running commands, spawning actors, and loading maps.5524 npm3MIT
- AlicenseAqualityDmaintenanceGives AI assistants a genuine Borland Turbo C 3.0 toolchain via MCP, enabling compile and run of real 16-bit DOS C programs with diagnostics and classic examples.121MIT