MCP Openmsx logo

MCP Openmsx

Unclaimed

by nataliapc

A Model Context Protocol (MCP) server for automating openMSX emulator instances. This server provides comprehensive tools for MSX software development, testing, and automation through standardized MCP protocols.

Set up this server

01 / Choose your client

02 / Before you connect

Authentication is not specified. Check the project instructions before connecting.

Install the runtime required by the project and make it available to your client.

Project instructions

Use names from the project instructions, separated by commas. Enter names only, never secret values.

03 / Add the configuration

Source: generated from public install instructions

claude mcp add --transport stdio 'mcp-openmsx' -- 'npx' '-y' '@nataliapc/mcp-openmsx'

Run in your terminal after replacing any placeholders.

04 / Check it in your client

Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.

More in Automation

Browse the full directory

Unclaimed listing

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

18 of 18 tools

Documented tools (18)

From project documentation. A server handshake does not verify each tool’s description or behavior.

basic_programming

BASIC tools: isBasicAvailable, newProgram, runProgram, setProgram, getFullProgram, getFullProgramAdvanced, listProgramLines, deleteProgramLines.

debug_breakpoints

Breakpoint management: create, remove, list.

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_run

Control execution: break, isBreaked, continue, stepIn, stepOut, stepOver, stepBack, runTo.

debug_vram

VRAM operations: getBlock, readByte, writeByte, searchBytes.

emu_control

Controls an openMSX emulator: launch, close, powerOn, powerOff, reset, getEmulatorSpeed, setEmulatorSpeed, machineList, extensionList, wait.

emu_info

Obtain informacion about the current emulated machine: getStatus, getSlotsMap, getIOPortsMap.

emu_keyboard

Send text or key combinations to emulator: sendText, sendKeyCombo.

emu_media

Manage ROM, disk, and tape media: tapeInsert, tapeRewind, tapeEject, romInsert, romEject, diskInsert, diskInsertFolder, diskEject.

emu_replay

Controls emulation timeline: start, stop, status, goBack, absoluteGoto, advanceFrame, reverseFrame, truncate, saveReplay, loadReplay.

emu_savestates

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

emu_vdp

Manage VDP (Video Display Processor): getPalette, getRegisters, getRegisterValue, setRegisterValue, screenGetMode, screenGetFullText.

msxdocs_resource_get

Retrieve MCP resources for MCP clients that don't support MCP resources.

openmsx_tcl_cmd

Executes a native Tcl command in the connected openMSX instance. It is disabled by default and is registered only when the user sets OPENMSXENABLERAWTCL=true. Existing typed tools remain available and are preferred for operations they cover.

screen_dump

Export screen data as BASIC BSAVE instruction.

screen_shot

Capture emulator screen: asimage, tofile.

vector_db_query

Hybrid search (semantic embeddings + BM25) over the local MSX documentation index, for information about MSX systems, cartridges, programming, and other development resources.

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about MCP Openmsx MCP Server

How do I connect MCP Openmsx MCP Server to Claude?
Run `claude mcp add mcp-openmsx -- npx -y @nataliapc/mcp-openmsx` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
Is MCP Openmsx MCP Server free?
The listed licence is GPL-2.0. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can MCP Openmsx MCP Server do?
MCP Openmsx MCP Server documents 18 tools to the agent, including basic_programming, debug_breakpoints, debug_cpu. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.