Model context protocol server for openMSX automation and control
Connect MCP to Claude, Cursor or any other MCP client and it stops being a tab you switch to. Model context protocol server for openMSX automation and control. The mcp mcp server is what makes that connection.
"Orchestrating a binary opera where AI conducts, MCP interprets, and openMSX acts as the 8-bit diva."
Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
emu_control — Controls an openMSX emulator: launch, close, powerOn, powerOff, reset, getEmulatorSpeed, setEmulatorSpeed, machineList, extensionList, waitemu_replay — Controls emulation timeline: start, stop, status, goBack, absoluteGoto, advanceFrame, reverseFrame, truncate, saveReplay, loadReplayemu_info — Obtain informacion about the current emulated machine: getStatus, getSlotsMap, getIOPortsMapemu_media — Manage ROM, disk, and tape media: tapeInsert, tapeRewind, tapeEject, romInsert, romEject, diskInsert, diskInsertFolder, diskEjectemu_vdp — Manage VDP (Video Display Processor): getPalette, getRegisters, getRegisterValue, setRegisterValue, screenGetMode, screenGetFullTextbasic_programming — BASIC tools: isBasicAvailable, newProgram, runProgram, setProgram, getFullProgram, getFullProgramAdvanced, listProgramLines, deleteProgramLinesdebug_run — Control execution: break, isBreaked, continue, stepIn, stepOut, stepOver, stepBack, runTodebug_cpu — Read/write CPU registers, CPU info, Stack pile, and Disassemble code: _getCpuRegisters, getRegister, setRegister, getStackPile, disassembledebug_memory — RAM memory operations: selectedSlots, getBlock, readByte, readWord, writeByte, writeWord, searchBytesdebug_vram — VRAM operations: getBlock, readByte, writeByte, searchBytesdebug_breakpoints — Breakpoint management: create, remove, listemu_keyboard — Send text or key combinations to emulator: sendText, sendKeyComboConfiguration is passed through the environment: OPENMSX_SHARE_DIR, OPENMSX_ENABLE_RAW_TCL, OPENMSX_EXECUTABLE, OPENMSX_SCREENSHOT_DIR, OPENMSX_SCREENDUMP_DIR, OPENMSX_REPLAYS_DIR, MCP_HTTP_PORT, MCP_ALLOWED_ORIGINS. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
Among the knowledge and memory options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. MCP's toolset — emu_control, emu_replay, emu_info and 11 more — is a fair guide to whether it matches your workflow. It is maintained by nataliapc; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| 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_. |
{
"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.
| 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 |
A knowledge graph your assistant keeps between sessions — entities, relations and observations that persist.
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Your workspace, on speaking terms with AI — search, read and write Notion pages and databases.
A structured scratchpad for hard problems — stepwise reasoning with revisions, branches and visible logic.
Symbol-level code navigation, refactoring and memory for coding agents — the IDE brain your assistant has been missing.
Chat with your second brain — search, read and write vault notes through the Local REST API.