Skip to content

Erodenn/godot-mcp-runtime

v2.2.2 Breaking

This release includes 1 breaking change for platform teams planning a safe upgrade.

Published 1mo MCP Developer Tools
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Affected surfaces

breaking_upgrade

Summary

AI summary

Node 18 dropped; minimum supported runtime is now >=20.

Full changelog

Test suite, CI, and contributor groundwork. One small runtime fix; Node 18 dropped.

Added

  • 591-test Vitest suite: tool handlers, MCP dispatch parity, GDScript op routing, real-Godot integration tests
  • CI workflow: verify matrix on Node 20 / 22 / 24, plus a godot-integration matrix on Godot 4.5.1 and 4.6.2 (Linux + xvfb)
  • Tag-triggered publish.ymlgit tag vX.Y.Z && git push --tags runs verify, publishes to npm with provenance, and creates the GitHub release
  • ESLint flat config + Prettier
  • npm run verify one-shot pre-commit runner (scripts/verify.sh)
  • CONTRIBUTING.md and tests/README.md
  • Minimal Godot 4 fixture project at tests/fixtures/godot-project/ (shared with CI)
  • Bridge health check for attached mode

Fixed

  • run_project now verifies the McpBridge UDP server is listening before returning, fixing a race where the first runtime tool call could time out (#7, thanks @johanravn)
  • Cross-platform path normalization in the bridge readiness check
  • Attached-mode bridge check validates project path and returns a structured error instead of throwing

Changed

  • Extracted MCP tool dispatch table from src/index.ts into src/dispatch.ts
  • Renamed four GDScript op names in godot_operations.gd to match their public MCP tool names (update_node_propertyset_node_property, batch_update_node_propertiesbatch_set_node_properties, connect_node_signalconnect_signal, disconnect_node_signaldisconnect_signal). No MCP tool names changed — internal alignment only.
  • Regenerated package-lock.json to fix Windows/Linux optionalDependencies drift on CI

Breaking

  • Node 18 dropped. engines.node is now >=20.0.0. Vitest 4 / vite 8 require Node ≥20.

Full changelog: https://github.com/Erodenn/godot-mcp-runtime/compare/v2.2.1...v2.2.2

Breaking Changes

  • Minimum supported Node.js version raised from >=18.0.0 to >=20.0.0 (Node 18 dropped).

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track Erodenn/godot-mcp-runtime

Get notified when new releases ship.

Sign up free

About Erodenn/godot-mcp-runtime

MCP server for Godot 4.x with runtime control via injected UDP bridge: input simulation, screenshots, UI discovery, and live GDScript execution while the game is running.

All releases →

Beta — feedback welcome: [email protected]