English Français العربية

Godot MCP

Registre officiel Autres

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package godot-mcp-uvx
Claude Code 
claude mcp add godot-mcp -- uvx godot-mcp-uvx==1.0.4
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "godot-mcp": {
            "command": "uvx",
            "args": [
                "godot-mcp-uvx==1.0.4"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. godot-mcp — Pure Python FastMCP Server for Godot 4
  2. Quick Start
  3. MCP Client Configuration
  4. Environment Variables
  5. Tools (28 total)
  6. Architecture
  7. Requirements
  8. License

godot-mcp — Pure Python FastMCP Server for Godot 4

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:

# 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_mcp
cd godot_mcp
uv 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):

{
  "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

Questions fréquentes

Qu'est-ce que Godot MCP ?

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

Comment installer Godot MCP ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add godot-mcp -- uvx godot-mcp-uvx==1.0.4. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Godot MCP ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Godot MCP est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Godot MCP ?

Il est publié par jxlee007. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.