@gikit/godot-mcp
v1.3.1
Published
Connect AI coding tools to the Godot Editor and running games through MCP.
Maintainers
Readme
GI Kit Godot MCP
gigdmcp connects MCP-compatible AI coding tools to the GI Kit Godot MCP
Addon. The npm package contains the CLI, shared Broker, MCP Attach, and their
internal protocol implementation. The Godot Addon is distributed separately.
Requirements
- Node.js 22 or newer
- The GI Kit Godot MCP Addon in the target Godot project
Install
npm install --global @gikit/godot-mcp
gigdmcp --versionMCP configuration
Configure a stdio MCP server with:
Command: gigdmcp
Arguments: attach
Working directory: leave emptyEach MCP connection starts a lightweight Attach. Attaches and Godot Editors share one user-level Broker, which starts automatically when needed.
The Godot Addon's Setup page provides a multiline English setup prompt. Copy it and send it to an MCP-capable AI client in the workspace used for the Godot project. The AI adds this entry in its supported project-level format and reloads the MCP connection. The Addon does not modify client configuration files.
Useful commands:
gigdmcp doctor
gigdmcp --help
gigdmcp config get logging.level
gigdmcp config set logging.level debugLess common configuration and service commands:
gigdmcp config get broker.port
gigdmcp config get broker.idle_timeout
gigdmcp broker start
gigdmcp broker stop
gigdmcp version --jsonThe package requires Node.js 22+ and is tested on Windows and macOS with Godot 4.7.x. Linux has not yet completed the same compatibility matrix. The package is distributed without an open-source license; installing it does not grant rights to redistribute or modify it.
