# dosbox-mcp

> dosbox-mcp is an open-source MCP server for developer tools. Drive a DOS machine from an agent: keys, screen text, recordings, Lua and memory. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Linux, Windows, CLI, API
- **Website:** https://dosbox-automation.org
- **Repository:** https://github.com/dosbox-automation/dosbox-mcp
- **MCP Registry name:** io.github.dosbox-automation/dosbox-mcp
- **Categories:** developer tools, games and play
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add dosbox-mcp -- uvx dosbox-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/dosbox-mcp
