MCP-openMSX

Name: MCP-openMSX
Author: nataliapc

@nataliapc

关于 MCP-openMSX

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.

基本信息

分类

其他

许可证

GPL-2.0

运行时

node

传输方式

stdio

发布者

nataliapc

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCP-openMSX?

MCP-openMSX is a Model Context Protocol server for automating openMSX emulator instances. It provides comprehensive tools for MSX software development, testing, and automation, bridging AI-assisted development (e.g., GitHub Copilot, Claude Desktop) with retro computing (MSX systems).

How to use MCP-openMSX?

Install the precompiled NPM package via npx @nataliapc/mcp-openmsx. Configure it in your MCP client (VSCode or Claude Desktop) using JSON with STDIO or HTTP transport. Environment variables allow customizing paths to the openMSX executable, share directory, screenshot folder, and more.

Key features of MCP-openMSX

Emulator control: launch, close, power, reset, speed, machine/extension list
Media management: insert/eject ROM cartridges, floppy disks, and cassette tapes
BASIC programming support with tools to edit and run programs
Full CPU debugging with breakpoints, memory inspection, and step execution
Video control: VDP register manipulation and screen capture
Memory operations: read/write RAM, VRAM, and I/O ports
Hybrid documentation search (semantic embeddings + BM25) offline

Use cases of MCP-openMSX

Automated testing of MSX software using AI-driven emulator control
Debugging MSX programs with breakpoints, memory inspection, and step execution
Developing and running BASIC programs directly from an AI assistant
Managing media (ROM, disk, tape) for retro gaming or development
Capturing screenshots and screen dumps for documentation or analysis

FAQ from MCP-openMSX

Does MCP-openMSX require openMSX to be installed?

Yes. The server controls a local openMSX emulator instance. You can specify the executable path via the OPENMSX_EXECUTABLE environment variable; otherwise it auto-detects common locations.