Model Context Protocol moderate risk

Godot

Godot MCP enables AI assistants to interact with the Godot game engine, automating tasks such as launching the editor, running projects, and managing scenes.

Connections & Capabilities

Connects To

GitHub

Capabilities

readwriteexec

Quickstart

Install

npm install
npm

Config

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/absolute/path/to/godot-mcp/build/index.js"],
      "env": {
        "DEBUG": "true"                  // Optional: Enable detailed logging
      },
      "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"
      ]
    }
  }
}

Exposed MCP Tools (14)

safe

launch_editor

Launches the Godot editor for a specific project.

Only opens the editor; no modification of files.

moderate

run_project

Executes a Godot project in debug mode.

Executes project code, which could have unintended consequences.

safe

get_debug_output

Retrieves console output and error messages from a running project.

Read-only operation; does not modify any files.

moderate

stop_project

Stops a running Godot project.

Terminates the project execution, potentially interrupting processes.

safe

get_godot_version

Retrieves the installed Godot version.

Read-only operation; no side effects.

safe

list_projects

Finds Godot projects in a specified directory.

Read-only operation; only lists files.

safe

get_project_info

Gets detailed information about project structure.

Read-only operation; no modification of files.

moderate

create_scene

Creates a new scene with specified root node types.

Creates a new file, but the content is controlled.

moderate

add_node

Adds nodes to existing scenes with customizable properties.

Modifies existing scene files.

moderate

load_sprite

Loads sprites and textures into Sprite2D nodes.

Modifies scene files to include sprite data.

moderate

export_mesh_library

Exports 3D scenes as MeshLibrary resources for GridMap.

Creates a new resource file based on scene data.

moderate

save_scene

Saves scenes with options for creating variants.

Overwrites existing scene files.

safe

get_uid

Gets UID for specific files (Godot 4.4+).

Read-only operation; retrieves file metadata.

high

update_project_uids

Updates UID references by resaving resources.

Modifies multiple project files, potentially causing data loss if interrupted.

Safety Assessment

Godot MCP offers powerful automation capabilities but requires careful configuration and monitoring. It is relatively safe when used with trusted projects and with user oversight. However, running untrusted projects or granting excessive permissions can lead to security risks.

Requires explicit approval for potentially destructive actions.
No direct internet exposure.
Operations are limited to the Godot project environment.
Uses a bundled GDScript approach to limit filesystem access.

Can execute code within the Godot environment, posing a risk if the project contains malicious code.
Can modify project files, potentially leading to data loss or corruption.
Lacks fine-grained permission controls; all approved tools have full access.
Relies on environment variables for configuration, which can be insecure if not properly managed.