How do I install the mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `OPENMSX_SHARE_DIR`, `OPENMSX_ENABLE_RAW_TCL`, `OPENMSX_EXECUTABLE`, `OPENMSX_SCREENSHOT_DIR`, `OPENMSX_SCREENDUMP_DIR`, `OPENMSX_REPLAYS_DIR`, `MCP_HTTP_PORT`, `MCP_ALLOWED_ORIGINS` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

MCP Server — nataliapc/mcp-openmsx

Model context protocol server for openMSX automation and control

Remote serverstreamable-httpTypeScript

What is the MCP Server?

Model context protocol server for openMSX automation and control

What the server does

"Orchestrating a binary opera where AI conducts, MCP interprets, and openMSX acts as the 8-bit diva."

Credentials and setup notes

Node.js >= 18.0.0 - TypeScript - openMSX emulator installed

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
emu_control	Controls an openMSX emulator: _launch, close, powerOn, powerOff, reset, getEmulatorSpeed, setEmulatorSpeed, machineList, extensionList, wait_.
emu_replay	Controls emulation timeline: _start, stop, status, goBack, absoluteGoto, advanceFrame, reverseFrame, truncate, saveReplay, loadReplay_.
emu_info	Obtain informacion about the current emulated machine: _getStatus, getSlotsMap, getIOPortsMap_.
emu_media	Manage ROM, disk, and tape media: _tapeInsert, tapeRewind, tapeEject, romInsert, romEject, diskInsert, diskInsertFolder, diskEject_.
emu_vdp	Manage VDP (Video Display Processor): _getPalette, getRegisters, getRegisterValue, setRegisterValue, screenGetMode, screenGetFullText_.
basic_programming	BASIC tools: _isBasicAvailable, newProgram, runProgram, setProgram, getFullProgram, getFullProgramAdvanced, listProgramLines, deleteProgramLines_.
debug_run	Control execution: _break, isBreaked, continue, stepIn, stepOut, stepOver, stepBack, runTo_.
debug_cpu	Read/write CPU registers, CPU info, Stack pile, and Disassemble code: _getCpuRegisters, getRegister, setRegister, getStackPile, disassemble, getActiveCpu_.
debug_memory	RAM memory operations: _selectedSlots, getBlock, readByte, readWord, writeByte, writeWord, searchBytes_.
debug_vram	VRAM operations: _getBlock, readByte, writeByte, searchBytes_.
debug_breakpoints	Breakpoint management: _create, remove, list_.
emu_keyboard	Send text or key combinations to emulator: _sendText, sendKeyCombo_.
emu_savestates	Save and restore machine states: _load, save, list_.
screen_shot	Capture emulator screen: _as_image, to_file_.

How to install the MCP Server

{
  "mcpServers": {
    "mcp-openmsx": {
      "command": "npx",
      "args": ["@nataliapc/mcp-openmsx"],
      "env": {
        "OPENMSX_SHARE_DIR": "C:\\the\\location\\of\\your\\openmsx\\share\\folder"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Node.js >= 18.0.0 - TypeScript - openMSX emulator installed

Variable	Description	Required
OPENMSX_SHARE_DIR	Filesystem location the server is allowed to use.	Optional
OPENMSX_ENABLE_RAW_TCL	Configuration value read at startup.	Optional
OPENMSX_EXECUTABLE	Configuration value read at startup.	Optional
OPENMSX_SCREENSHOT_DIR	Filesystem location the server is allowed to use.	Optional
OPENMSX_SCREENDUMP_DIR	Filesystem location the server is allowed to use.	Optional
OPENMSX_REPLAYS_DIR	Filesystem location the server is allowed to use.	Optional
MCP_HTTP_PORT	Configuration value read at startup.	Optional
MCP_ALLOWED_ORIGINS	Configuration value read at startup.	Optional

Example prompts to try

“Use MCP to emu control.”
“Use MCP to emu replay.”
“Use MCP to emu info.”

Frequently asked questions

Model context protocol server for openMSX automation and control Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.