Gaming & Gamification · Developer Tools

MCP Openmsx logo

MCP Openmsx

nataliapc/mcp-openmsx

This server provides comprehensive tools for MSX software development, testing, and automation through standardized MCP protocols.

Install

npx @nataliapc/mcp-openmsx

Client configuration

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

Environment variables

OPENMSX_SHARE_DIROPENMSX_EXECUTABLEOPENMSX_SCREENSHOT_DIROPENMSX_SCREENDUMP_DIROPENMSX_REPLAYS_DIROPENMSX_ENABLE_RAW_TCLOPENMSX_LAUNCH_HEADLESSMCP_HTTP_PORTMCP_ALLOWED_ORIGINS
Category
Gaming & Gamification, Developer Tools
License
GPL-2.0
Updated
Oct 6, 2026

About MCP Openmsx

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

Tools (20)

  • 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, writeBlock, searchBytes.

  • debug_vram

    VRAM operations: getBlock, readByte, writeByte, searchBytes.

  • debug_breakpoints

    Breakpoint management: create, remove, list.

  • debug_log

    Debug log: log, read.

  • debug_conditions

    Condition management (like breakpoints, but not tied to an address — a Tcl expression evaluated continuously while the CPU runs): 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.

  • screen_dump

    Export screen data as BASIC BSAVE instruction.

  • msxdocs_resource_get

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

  • vector_db_query

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

  • openmsx_tcl_cmd

    Executes a native Tcl command in the connected openMSX instance.

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS
VS Code GitHub Copilot logo

VS Code GitHub Copilot

Desktop · Freemium · MIT

VS Code integrates MCP with GitHub Copilot through agent mode, allowing direct interaction with MCP-provided tools in your agentic coding workflow. Configure servers in Claude Desktop, workspace, or user settings, with guided MCP installation and secure handling of secrets in input variables to avoid leaking hardcoded keys.

WindowsMacOSLinuxWeb

Related MCP servers

More servers
HAN JIE logo

HAN JIE

hedge-dev/XenonRecomp

6k

XenonRecomp is a tool that converts Xbox 360 executables into C++ code, which can then be recompiled for any platform.

Gaming & Gamification
Unity MCP logo

Unity MCP

justinpbarnett/unity-mcp

1.8k

Create your Unity apps with LLMs. MCP for Unity bridges AI assistants — Claude, Codex, VS Code, local LLMs, and more — with your Unity Editor via Model Context Protocol. Give your LLM the tools to manage assets, control scenes, edit scripts, run tests, and automate your game dev workflows.

Gaming & Gamification
Unreal MCP logo

Unreal MCP

chongdashu/unreal-mcp

542

This project enables AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).

Gaming & Gamification
MCP Unity logo

MCP Unity

codergamester/mcp-unity

435

MCP Unity is an implementation of the Model Context Protocol for Unity Editor, allowing AI assistants to interact with your Unity projects.

Gaming & Gamification
Unity logo

Unity

arodoid/unitymcp

422

UnityMCP is a powerful Unity Editor plugin that implements the Model Context Protocol (MCP), enabling seamless integration between Unity and AI assistants. It provides real-time editor state monitoring, remote command execution, and comprehensive logging capabilities.

Gaming & Gamification
Godot logo

Godot

coding-solo/godot-mcp

329

Godot MCP enables AI agents to launch the Godot editor, run projects, capture debug output, and control project execution. This direct feedback loop helps agents understand what works and what doesn't in real Godot projects, leading to better code generation and debugging assistance.

Gaming & Gamification