Godot MCP

io.github.jxlee007Published by GitHub account jxlee007v1.0.4Updated Oct 24, 2026

Pure-Python FastMCP server for Godot 4 — 28 headless & animation tools. Runs via uvx.

VerifiedSTDIODesktop onlyDeveloper ToolsMedia & Design

Overview

AI-generated overview

A local MCP server that lets an assistant drive Godot 4 headlessly: run projects, edit scenes, and generate animation, camera and shader assets.

What you can do
Check the Godot install, list and inspect projects, and launch the editor or run a project in debug mode with captured output and stop control. Create, save and modify scenes and nodes, load sprites, export mesh libraries, and read or regenerate resource UIDs. Quantize keyframes, swap interpolation modes, stitch animation libraries, and build state machines, transitions and 2D blend spaces. Generate bezier camera paths, look-at tracking scripts and camera-switch timelines. Batch-edit shader uniforms and texture slots, toggle Movie Maker, and run headless diagnostics.
When to use it
Useful when working on Godot 4 game projects and you want an assistant to scaffold scenes, wire up animation trees and cameras, or run and debug the project without manual editor clicking.
Requirements
Local process run via uvx from the godot-mcp-uvx PyPI package; needs Python 3.10+ and a Godot 4.x executable, located through the GODOT_PATH environment variable or the system PATH. Optional DEBUG variable enables verbose logging.
Before you install
Many tools write to project files: scenes, resources, project settings and shader parameters are modified in place, and UID regeneration resaves all resources. Running and stopping projects starts and kills Godot processes. Point it at a version-controlled or backed-up project.

Installation

In SourceWeft

  1. Open Godot MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

godot-mcp — Pure Python FastMCP Server for Godot 4

[Python] [FastMCP] [License: MIT] [M8ven Verified]

A zero Node.js Model Context Protocol server for Godot 4 — translated from Coding-Solo/godot-mcp and youichi-uda/godot-mcp-pro into pure Python using the official FastMCP framework. Runs with ultra-low RAM via uvx.

Quick Start

You can invoke this server over standard I/O (stdio) from anywhere on your machine instantly using uvx without manually cloning files or configuring virtual environments:

bash
# Run globally via uvx from PyPI (Bypasses local setup completely)GODOT_PATH=/path/to/godot4 uvx --from godot-mcp-uvx godot-mcp
# Local development installation (For active contributors)git clone https://github.com/jxlee007/godot_mcpcd godot_mcpuv tool install --editable .

MCP Client Configuration

Add this structural configuration block straight into your global client matrix environment profile (e.g., ~/.gemini/antigravity-cli/settings.json or Claude / Cline settings):

json
{  "mcpServers": {    "godot_render": {      "command": "uvx",      "args": [        "--from",        "godot-mcp-uvx",        "godot-mcp"      ],      "env": {        "GODOT_PATH": "/path/to/godot4",        "DEBUG": "false"      }    }  }}

Environment Variables

VariableDescription
GODOT_PATHPath to the Godot 4 executable (auto-detected if unset)
DEBUG"true" enables verbose stderr logging

Tools (28 total)

Core Runtime (14)

ToolDescription
get_godot_versionReturn installed Godot version
launch_editorOpen Godot editor for a project
run_projectRun project in debug mode, capture output
get_debug_outputRead stdout/stderr from running project
stop_projectKill running project, return final output
list_projectsFind Godot projects in a directory
get_project_infoMetadata, file counts, version
create_sceneCreate a new .tscn file via GDScript
add_nodeAdd a node to an existing scene
load_spriteLoad texture onto Sprite2D/TextureRect
export_mesh_libraryExport .tscn as MeshLibrary .res
save_sceneSave / save-as a scene file
get_uidGet UID for a Godot 4.4+ resource
update_project_uidsResave all resources to regenerate UIDs

Animation Text Pipeline (4)

ToolDescription
quantize_animation_keyframesRound timestamps to fixed fps increments (12/24 fps anime look)
set_animation_interpolation_modeBulk-swap easing: linear, cubic, nearest/stepped
stitch_animation_libraryMerge external .glb/.tres clips into master AnimationLibrary
generate_track_filterGenerate AnimationNodeBlendFilter for upper/lower body isolation

AnimationTree Blueprinting (3)

ToolDescription
generate_state_machineInject AnimationNodeStateMachine into a .tscn file
compile_state_transitionsWrite transition arrows with conditions
calculate_blend_space_2dGenerate 2D blend space for directional locomotion

Camera & Cinematic (3)

ToolDescription
generate_bezier_camera_pathCatmull-Rom bezier Path3D + PathFollow3D + Camera3D with tension control
inject_lookat_trackingGenerate LookAt tracking GDScript for Camera3D
build_camera_switcher_timelineWrite Animation that switches Camera3D.current at timestamps

NPR Materials & Shaders (2)

ToolDescription
batch_shader_uniformsBulk-override shader_parameter/* in all .tres files
remap_texture_channelsWire textures into material property slots

Pipeline Automation (2)

ToolDescription
toggle_movie_makerEdit project.godot to enable/disable Movie Maker mode
run_headless_diagnosticsValidate imports, UIDs, shader entry points via Godot CLI

Architecture

src/godot_mcp/├── __init__.py├── server.py              # FastMCP app — all 28 tools└── scripts/    └── godot_operations.gd  # Bundled GDScript engine (preserved untouched)

Two operation modes:

  1. Subprocess bridge — core 14 tools invoke godot_operations.gd headlessly via subprocess.run()
  2. Text manipulation — pro-port 14 tools parse/write .tscn, .tres, project.godot files as plain text using Python stdlib re only

Requirements

  • Python 3.10+
  • Godot 4.x installed (set GODOT_PATH or ensure it is on $PATH)
  • uv or pip

License

MIT

Source: README.md at commit 3b7ff9e

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.4LatestSep 26, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts