nataliapc/mcp-openmsx

3.5

If you are the rightful owner of mcp-openmsx and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The MCP-openMSX server is a bridge between modern AI-assisted development and retro computing, providing tools for MSX software development, testing, and automation.

Tools

Functions exposed to the LLM to take actions

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, truncate, saveReplay, loadReplay.

emu_info

Obtain information 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: 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, advanced_basic_listing.

debug_vram

VRAM operations: getBlock, readByte, writeByte.

debug_breakpoints

Breakpoint management: create, remove, list.

emu_keyboard

Send text input to emulator: sendText.

emu_savestates

Save and restore machine states: load, save, list.

screen_shot

Capture emulator screen: as_image, to_file.

screen_dump

Export screen data as BASIC BSAVE instruction.

Prompts

Interactive templates invoked by user choice

No prompts

Resources

Contextual data attached and managed by the client

No resources

Author

nataliapc

Claim Ownership

Verify you have write access to the repository

Version

v1.2.4

Repository

https://github.com/nataliapc/mcp-openmsx

GitHub Stars

License

GNU General Public License v2.0

Last publish date

2025-07-28

Last update date

2025-09-20

Server configs

in vscode

{
  "servers": {
    "mcp-openmsx": {
      "command": "npx",
      "args": ["@nataliapc/mcp-openmsx"],
      "env": {
        "OPENMSX_SHARE_DIR": "/usr/share/openmsx"
      }
    }
  }
}

in vscode

{
  "servers": {
    "mcp-openmsx": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": { }
    }
  }
}

in claude desktop

{
  "mcpServers": {
    "mcp-openmsx": {
      "command": "npx",
      "args": ["@nataliapc/mcp-openmsx"],
      "env": {
        "OPENMSX_SHARE_DIR": "/usr/share/openmsx"
      }
    }
  }
}