mcpField
G
Godot MCP

Godot MCP

Local
github.comDeveloper Tools1Updated 2w ago
RepositoryVisit website

About Godot MCP

Edit Godot 4 scenes, nodes and scripts; run, test and debug games live in the editor or headless

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "shin2344234-godot": {
      "command": "npx",
      "args": [
        "-y",
        "@shin2344234/godot-mcp"
      ],
      "env": {
        "GODOT_PROJECT_PATH": "<GODOT_PROJECT_PATH>",
        "GODOT_PATH": "<GODOT_PATH>",
        "GODOT_MCP_MODE": "<GODOT_MCP_MODE>",
        "GODOT_MCP_TOOLSETS": "<GODOT_MCP_TOOLSETS>",
        "GODOT_MCP_READ_ONLY": "<GODOT_MCP_READ_ONLY>",
        "GODOT_MCP_ALLOW_EVAL": "<GODOT_MCP_ALLOW_EVAL>",
        "GODOT_MCP_CONFIRM": "<GODOT_MCP_CONFIRM>",
        "GODOT_MCP_LOG_LEVEL": "<GODOT_MCP_LOG_LEVEL>",
        "GODOT_MCP_HEADLESS_TIMEOUT_MS": "<GODOT_MCP_HEADLESS_TIMEOUT_MS>",
        "GODOT_MCP_BRIDGE_TIMEOUT_MS": "<GODOT_MCP_BRIDGE_TIMEOUT_MS>",
        "GODOT_MCP_LSP_PORT": "<GODOT_MCP_LSP_PORT>",
        "GODOT_MCP_LSP_TIMEOUT_MS": "<GODOT_MCP_LSP_TIMEOUT_MS>",
        "GODOT_MCP_LSP_IDLE_MS": "<GODOT_MCP_LSP_IDLE_MS>",
        "GODOT_MCP_CACHE_DIR": "<GODOT_MCP_CACHE_DIR>"
      }
    }
  }
}
Run commandnpx -y @shin2344234/godot-mcp
Environment variables to set
GODOT_PROJECT_PATHFolder of the Godot project (the one containing project.godot). Defaults to the folder the client starts the server in, so set it whenever that is not your project (e.g. in desktop apps).
GODOT_PATHFull path of the Godot 4.x executable (GODOT_BIN is accepted too). If unset, the server looks for godot, godot4 or Godot_v4* on PATH. On Windows use the main Godot exe, not the _console.exe launcher.
GODOT_MCP_MODEHow tools are exposed: 'full' lists every enabled operation as its own tool (best for clients with tool search); 'compact' lists only core tools plus router tools that reach the rest.
GODOT_MCP_TOOLSETSComma-separated tool groups to enable, or 'all' (default). Groups: core, files, scene, node, script, run, editor, signal, resource, visual, anim, world, audio, project, import, export, code, docs, game, debug, test. 'core' is always on.
GODOT_MCP_READ_ONLYSet to true to hide every tool that changes something (inspection only).
GODOT_MCP_ALLOW_EVALSet to true to let godot_game_eval run GDScript inside the running game. Off by default: evaluated code can do anything the game can (files, OS calls).
GODOT_MCP_CONFIRM'elicit' asks the user (through the client's elicitation dialog, when supported) before irreversible operations; 'never' skips asking, for unattended runs where nobody can answer.
GODOT_MCP_LOG_LEVELVerbosity of the server's stderr log (use 'debug' when filing a bug report).
GODOT_MCP_HEADLESS_TIMEOUT_MSAdvanced: timeout for one headless Godot invocation, in milliseconds.
GODOT_MCP_BRIDGE_TIMEOUT_MSAdvanced: timeout for one request to the live editor bridge, in milliseconds.
GODOT_MCP_LSP_PORTAdvanced: port of the Godot editor's GDScript language server on 127.0.0.1. Defaults to the port the editor plugin reports, else 6005.
GODOT_MCP_LSP_TIMEOUT_MSAdvanced: timeout for one GDScript language server request, in milliseconds.
GODOT_MCP_LSP_IDLE_MSAdvanced: stop the private headless language server after this many milliseconds without code tool calls.
GODOT_MCP_CACHE_DIRAdvanced: folder for the server's cache (the Godot class docs index). Defaults to the per-user cache folder of the OS.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@shin2344234/godot-mcp0.1.2

Tools

91

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

The maintainer has not added details yet. Check the README in the repository.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.