An MCP server that enables AI assistants to interact with the Godot game engine, providing capabilities for launching the editor, executing projects, capturing debug output, and managing scenes through a standardized interface.

Installation

From Source Code

git clone https://github.com/Coding-Solo/godot-mcp.git
cd godot-mcp
npm install
npm run build

Configuration

Cline

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/absolute/path/to/godot-mcp/build/index.js"],
      "env": {
        "DEBUG": "true"
      },
      "disabled": false,
      "autoApprove": [
        "launch_editor",
        "run_project",
        "get_debug_output",
        "stop_project",
        "get_godot_version",
        "list_projects",
        "get_project_info",
        "create_scene",
        "add_node",
        "load_sprite",
        "export_mesh_library",
        "save_scene",
        "get_uid",
        "update_project_uids"
      ]
    }
  }
}

Cursor Project-Specific

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/absolute/path/to/godot-mcp/build/index.js"],
      "env": {
        "DEBUG": "true"
      }
    }
  }
}

Available Tools

Tool	Description
launch_editor	Launch the Godot editor for a specific project
run_project	Execute Godot projects in debug mode
get_debug_output	Retrieve console output and error messages
stop_project	Stop running Godot projects
get_godot_version	Get the version of installed Godot
list_projects	Find Godot projects in a specified directory
get_project_info	Get detailed information about project structure
create_scene	Create new scenes with specified root node types
add_node	Add nodes to existing scenes with customizable properties
load_sprite	Load sprites and textures into Sprite2D nodes
export_mesh_library	Export 3D scenes as MeshLibrary resources for GridMap
save_scene	Save scenes with options for creating variants
get_uid	Get UID for specific files (Godot 4.4+)
update_project_uids	Update UID references by resaving resources (Godot 4.4+)

Capabilities

• Launch the Godot editor for specific projects
• Execute Godot projects in debug mode and capture output
• Programmatically control project execution
• Analyze projects and retrieve structure information
• Manage scenes with node creation and modification
• Load sprites and textures for 2D nodes
• Export 3D scenes as MeshLibrary resources
• Manage UIDs for Godot 4.4+ projects
• Direct feedback for AI code generation and debugging

Environment Variables

Optional

• GODOT_PATH - Path to the Godot executable (overrides automatic detection)
• DEBUG - Set to "true" to enable detailed server-side logging

Usage Examples

Launch the Godot editor for my project at /path/to/project

Run my Godot project and show any errors

Get information about my Godot project structure

Analyze my Godot project structure and suggest improvements

Help me debug this error in my Godot project: [paste error]

Notes

Requires Godot Engine to be installed on your system. Uses an embedded GDScript approach for complex operations, eliminating temporary files and ensuring better maintainability. For Cursor users, MCP tools can only be executed using the Agent chat profile (requires Cursor Pro or Business subscription).