Skip to content
MCP server

dosbox-mcp

Drive a DOS machine from an agent: keys, screen text, recordings, Lua and memory

Runs locallyStatus and history
Pricing
Open source
Platforms
Linux, Windows, CLI
Runs
Locally
Version
0.2.4
Listing updated
3 days ago

About dosbox-mcp

dosbox-mcp is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

dosbox-mcp is the MCP front end for dosbox-automation, a DOSBox fork with an HTTP REST API and a sandboxed Lua engine. Through it an agent can start, drive and inspect DOS programs and games, with frame-accurate timing, rather than only launching them.

The underlying emulator offers keyboard and mouse input with recording and replay, video and audio capture, screen text reading in text modes, memory search, value freezes and register access. Recordings carry the settings that determinism needs, so a captured installation replays the same way on another machine, and declarative TOML recipes turn into unattended installs including disk swaps.

Archives in zip, rar, 7z and iso mount as drives without unpacking, and saves go to their own folder. The REST API uses token authentication, and the MCP server includes a bridge_status check. It installs from PyPI and runs over stdio.

Install

Run in a terminal

claude mcp add dosbox-mcp -- uvx dosbox-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "dosbox-mcp": {
      "command": "uvx",
      "args": [
        "dosbox-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "dosbox-mcp": {
      "command": "uvx",
      "args": [
        "dosbox-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "dosbox-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "dosbox-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "dosbox-mcp": {
      "command": "uvx",
      "args": [
        "dosbox-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "dosbox-mcp": {
      "command": "uvx",
      "args": [
        "dosbox-mcp"
      ]
    }
  }
}

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

bridge_status
Reports whether the server can reach the dosbox-automation API.

What it does

Input and screen
Send keys and mouse input, and read screen text in text modes.
Record and replay
Capture input and video or audio and replay deterministically.
Lua scripting
Sandboxed engine with frame-accurate timing.
Memory and registers
Search memory, freeze values and read registers.
Archive mounting
Mounts zip, rar, 7z and iso files as drives.
Install recipes
TOML recipes drive unattended installs.

Good for

  • Automate installing a DOS game
  • Test a DOS program with replayable input
  • Debug memory in a retro application
  • Integrate a game launcher with an emulator

Pricing

Open source

Source distribution available

Prices change. Check dosbox-automation.org before you buy.

dosbox-mcp FAQ

What platforms does the emulator support?

Linux and Windows.

How does the REST API authenticate?

With tokens; the server works from a token file.

Can it read text from the screen?

Yes, in text modes.

How is the server installed?

From PyPI as dosbox-mcp, over stdio.

Is dosbox-mcp free?

Yes. dosbox-mcp is open source, so you can use and self-host it for free.

How do I add dosbox-mcp to Claude Code?

Run this command in your terminal: claude mcp add dosbox-mcp -- uvx dosbox-mcp

What are the best alternatives to dosbox-mcp?

The closest alternatives to dosbox-mcp are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to dosbox-mcp

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools