# 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

- **URL**: https://www.freshcrate.ai/projects/mcp-openmsx
- **Author**: nataliapc
- **Category**: MCP Servers
- **Latest version**: `v1.2.9` (2026-04-15)
- **License**: GPL-2.0
- **Source**: https://github.com/nataliapc/mcp-openmsx
- **Language**: TypeScript
- **GitHub**: 54 stars, 6 forks
- **Registry**: github
- **Tags**: `typescript`

## Description

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.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v1.2.9` | 2026-04-15 | High | # What's New  ## Unit Test Suite  - **Vitest test framework added** — The project now includes a full unit test suite using [Vitest](https://vitest.dev/). Run tests with `npm test`, watch mode with `npm run test:watch`, and coverage reports with `npm run test:coverage`. - **Command queue tests** — Covers `sendCommand()` serialization, reply parsing (success/error/HTML entities), concurrent command queuing, 10-second timeout behavior, buffer desync prevention, and error recovery after failur |
| `v1.2.8` | 2026-04-11 | High | # What's New  ## Windows: TCP + SSPI Authentication (Breaking Protocol Change)  - **TCP socket with SSPI authentication** — The Windows communication has been completely rewritten. The previous named-pipe approach (`-control pipe:<name>`) is replaced by TCP socket connection with SSPI (Negotiate/NTLM) authentication, matching the protocol used by the [openMSX debugger](https://github.com/openMSX/debugger). This fixes emulator control reliability on Windows. The optional `node-expose-sspi` np |
| `v1.2.7` | 2026-04-09 | Medium | # What's New  ## Windows: Correct Control Protocol  - **Named pipe control for Windows** — The MCP server now uses `-control pipe:<name>` on Windows instead of `-control stdio`. This follows the [official openMSX documentation](https://openmsx.org/manual/openmsx-control.html) and fixes a known issue where the `StdioConnection` stdin reader thread hangs on exit because `read()` never unblocks cleanly on Windows. Commands are sent to openMSX via a Windows named pipe (`\\.\pipe\openmsx-mcp-<pid |
| `v1.2.6` | 2026-04-08 | Medium | # What's New  ## New Features  - **RAM byte-sequence search** — `debug_memory.searchBytes` scans a range of RAM for a given sequence of bytes, making it easy to locate routines, data structures, or magic values at runtime without manual stepping. - **VRAM byte-sequence search** — `debug_vdp.searchBytes` does the same across Video RAM, useful for finding sprite tables, tile patterns, or screen data that has been loaded into VRAM.  ## Bug Fixes & Cross-Platform Improvements  - **Windows: |
| `v1.2.5` | 2026-03-27 | Medium | # What's New ## New Features - **Screenshot double-size option** — The screenshot command now supports a doublesize option for higher resolution captures. - **Key combo support** — New emu_keyboard.sendKeyCombo command allows sending keyboard combinations (e.g. CTRL+STOP) to the openMSX emulator. - **Interactive machine & extension resolution** — The launch command now uses user elicitation to interactively resolve machine type and extensions when not explicitly specified. - **Structured Co |
| `v1.2.4` | 2025-08-01 | Low | - Refactored the server codebase into separate modules for Tools, Resources, and Prompts, improving maintainability and structure. - Enhanced the handling of BASIC `setProgram` tool for more robust BASIC program management. - Updated project dependencies to their latest versions for improved stability and compatibility. |
| `v1.2.3` | 2025-07-23 | Low | **Vector Database:** - Updated the embedded **Vector Database** (RAG) with a lot of new resources embeddings.  **Tools:** - Adding auto-detection of the **openMSX** share directory when `OPENMSX_SHARE_DIR` is missing or empty.  **Resources:** - Adds MSX-DOS resources about environment variables, and know file extensions. - Now, a lot of external resources are local.  **Others:** - README enhances installation and usage instructions. - README architecture diagram enhanced and updated. |
| `v1.2.2` | 2025-07-20 | Low | **Vector Database:** - Includes an embedded **Vector Database** (RAG) to enable semantic searches across the available **MSX** resources.  **Tools:** - `vector_db_query`: A new tool that semantically queries the vector database of embeddings to retrieve the most relevant resource data for any given question. - `msxdocs_resource_get`: Retrieve MCP resources for MCP clients that don't support MCP resources.  **Resources:** - Adds a local comprehensive set of markdown files containing docum |
| `v1.1.15` | 2025-07-12 | Low | **Tools:** - Adds a new tool `msxdocs_resource_get` that allows clients to retrieve MSX documentation resources directly, addressing the needs of clients that may not natively support MCP resources.  **Resources:** - Adds SDCC 4.5.2 Manual - Adds technical documentation for MoonSound and MGSC MML - Simplifies MSX BASIC instruction template completion - Adds instruction index to Z80 documentation  **Others:** - Sanitizes HTML content fetched from URLs - Updates MCP SDK dependency - Co |
| `v1.1.14` | 2025-07-07 | Low | - Improved resources. |

## Citation

- HTML: https://www.freshcrate.ai/projects/mcp-openmsx
- Markdown: https://www.freshcrate.ai/projects/mcp-openmsx.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/mcp-openmsx/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._