better-godot-mcp

Overview

This MCP server offers comprehensive tooling for Godot Engine through 17 composite mega-tools covering scenes, nodes, scripts, shaders, animations, tilemaps, physics, audio, navigation, UI, and more. It enables full scene control including creating, parsing, and modifying .tscn files without Godot running, along with GDScript CRUD operations. The server features tiered token optimization with compressed descriptions and an on-demand help tool.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• project

  Project metadata, run/stop, and settings management

  Try:Show me project informationTry:Run the game projectTry:Export the project to a build
• scenes

  Scene file management (create, list, delete, duplicate)

  Try:List all scenes in the projectTry:Create a new scene called 'player'Try:Duplicate the main scene
• nodes

  Scene tree node manipulation (add, remove, rename)

  Try:Add a new node to the sceneTry:Rename this node to 'player'Try:Get the position property of this node
• scripts

  GDScript file CRUD operations

  Try:Create a new GDScript fileTry:Read the content of the player scriptTry:Attach this script to the node
• editor

  Launch Godot editor and check status

  Try:Launch the Godot editorTry:Check if the editor is running
• resources

  Resource file management

  Try:List all resources in the projectTry:Delete this resource fileTry:Import resource configuration
• input_map

  Input action and event mapping

  Try:List all input actionsTry:Add a new action called 'jump'Try:Remove the 'fire' action
• signals

  Signal connections management

  Try:List all signals in this nodeTry:Connect this signal to that functionTry:Disconnect this signal
• animation

  Animation players and tracks management

  Try:Create a new animation playerTry:Add a new animation trackTry:Add a keyframe to this animation
• tilemap

  TileMap and TileSet management

  Try:Create a new tilesetTry:Add a new tile sourceTry:Paint tiles on the tilemap
• shader

  Shader file CRUD with Godot 4 syntax

  Try:Create a new shader fileTry:Read the shader codeTry:Get shader parameters
• physics

  Collision layers and physics bodies configuration

  Try:List physics collision layersTry:Set up collision for this objectTry:Configure physics body properties

Comparable tools

Installation

{
  "better-godot-mcp": {
    "command": "npx",
    "args": ["@n24q02m/better-godot-mcp"]
  }
}

npm install -g @n24q02m/better-godot-mcp

docker run n24q02m/better-godot-mcp

FAQ

What Godot versions does this MCP server support?

The server requires Godot 4.x project structure. It works with Godot binary version 4.x, which is auto-detected from common install locations.

Can I use this MCP server without installing Godot?

For basic file operations (scenes, nodes, scripts), yes. However, actions like 'run', 'stop', and 'export' require the Godot binary to be installed.

Compare better-godot-mcp with