MCP DOS

Provides access to classic DOS games via js-dos emulation in the browser with start/stop controls and on-screen keyboard mappings.

typescript

4

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "basementstudio-mcp-dos": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-dos"
      ]
    }
  }
}

You can run and play classic DOS games in a browser-based environment through the MCP DOS server. It uses js-dos for authentic emulation, letting you start, play, and switch between games like DOOM, Super Mario, Tetris, and Duke Nukem 3D directly from your MCP client with convenient on-screen controls and fullscreen gameplay.

How to use

To use the MCP DOS server with your MCP client, add the MCP DOS server configuration to your client, then start the server from your MCP dashboard or CLI. Once running, you can list games, open a game in a browser window, and control gameplay using the on-screen controls and keyboard mappings.

Add the MCP DOS server to your client configuration using the following example. This enables you to run the server locally via npx and connect your MCP client to it.

{
  "mcpServers": {
    "mcp_dos": {
      "command": "npx",
      "args": ["-y", "mcp-dos"]
    }
  }
}

Game access is provided through tools that let you list available DOS games, open a game in a new browser window, and close an active server when you’re done. Use the open-dos tool to launch a specific game in your browser, with fullscreen support and on-screen controls.

How to install

Prerequisites: you need Node.js version 20 or newer and a modern web browser with JavaScript enabled. An active internet connection is required for js-dos resources.

Install dependencies and build the project, then run the server locally.

# Install dependencies
pnpm install

# Build the project
pnpm build

# Run the server
pnpm start

Game controls and available games

Available games include DOOM, Super Mario, Tetris, and Duke Nukem 3D. Each game provides on-screen controls tailored to the game and compatible keyboard mappings for convenient play.

DOOM controls: Arrow Keys move, W uses, S fires, A/D strafes, Enter navigates menus. Super Mario uses Arrow keys for movement and Alt to jump. Tetris uses 7/8 to move, 9 to rotate, Space to drop, Enter to navigate menus. Duke Nukem 3D uses Arrow Keys for movement, Ctrl to fire, A to jump, Enter for menus.

Available tools

List DOS Games

Lists all available DOS games that can be played through the server and returns an array of game slugs.

open-dos

Opens and plays a specific DOS game in a new browser window using js-dos emulation, with fullscreen support and on-screen controls.

close-app

Closes a running MCP DOS server instance by port to help with cleanup and maintenance.