Skip to content

v1.2.13

Latest
Latest

Choose a tag to compare

View all tags
@nataliapc nataliapc released this 12 Jul 11:02
v1.2.13
a54d429

What's New

Optional Native Tcl Command Tool

  • Added openmsx_tcl_cmd, an advanced MCP tool that executes a native Tcl command in the active openMSX instance and returns its raw result.
  • The tool is disabled by default. Enable it explicitly with:
  OPENMSX_ENABLE_RAW_TCL=true
  • Use it for advanced or version-specific openMSX functionality not covered by the typed MCP tools. Existing typed tools remain the preferred interface where available.
  • The tool supports runtime discovery through native openMSX commands such as help, about, openmsx_info, and machine_info.
  • Input validation rejects unsupported XML control characters, limits commands to 16,384 characters, and truncates oversized results to protect MCP client context.

Documentation and Tests

  • Added a native Tcl autodiscovery guide to the mcp-openmsx-usage skill.
  • Documented OPENMSX_ENABLE_RAW_TCL in the README, server help, and environment-variable reference.
  • Added unit coverage for registration, opt-in behavior, input validation, command forwarding, error responses, and result truncation.

Upgrade Notes

This release introduces no breaking changes. The new Tcl tool is opt-in and does not affect existing MCP tool registrations unless OPENMSX_ENABLE_RAW_TCL=true is set.

Security note: Native Tcl access can control openMSX broadly and may access the host filesystem through openMSX commands. Enable it only for trusted MCP clients and workflows.

Full Changelog: https://github.com/nataliapc/mcp-openmsx/compare/v1.2.12...v1.2.13

Assets 2
Loading