How do I install Godot ?

Godot is a local plugin. Install it using PyPI package: godot-mcp-uvx and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Godot safe to use?

Yes. Godot passed MCP Marketplace's automated security scan with a score of 10/10 (low risk). Every server on MCP Marketplace is security-scanned before it's listed; see the full security report on this page for the findings and permissions.

What AI apps work with Godot ?

Godot uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Godot MCP Server

by Jxlee007

Developer ToolsLow Risk10.0MCP RegistryLocal

Free

Server data from the Official MCP Registry

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

About

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

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (1 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

3 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-jxlee007-godot-mcp": {
      "args": [
        "godot-mcp-uvx"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

Variable	Description
`GODOT_PATH`	Path to the Godot 4 executable (auto-detected if unset)
`DEBUG`	`"true"` enables verbose stderr logging

Tools (28 total)

Core Runtime (14)

Tool	Description
`get_godot_version`	Return installed Godot version
`launch_editor`	Open Godot editor for a project
`run_project`	Run project in debug mode, capture output
`get_debug_output`	Read stdout/stderr from running project
`stop_project`	Kill running project, return final output
`list_projects`	Find Godot projects in a directory
`get_project_info`	Metadata, file counts, version
`create_scene`	Create a new .tscn file via GDScript
`add_node`	Add a node to an existing scene
`load_sprite`	Load texture onto Sprite2D/TextureRect
`export_mesh_library`	Export .tscn as MeshLibrary .res
`save_scene`	Save / save-as a scene file
`get_uid`	Get UID for a Godot 4.4+ resource
`update_project_uids`	Resave all resources to regenerate UIDs

Animation Text Pipeline (4)

Tool	Description
`quantize_animation_keyframes`	Round timestamps to fixed fps increments (12/24 fps anime look)
`set_animation_interpolation_mode`	Bulk-swap easing: linear, cubic, nearest/stepped
`stitch_animation_library`	Merge external .glb/.tres clips into master AnimationLibrary
`generate_track_filter`	Generate AnimationNodeBlendFilter for upper/lower body isolation

AnimationTree Blueprinting (3)

Tool	Description
`generate_state_machine`	Inject AnimationNodeStateMachine into a .tscn file
`compile_state_transitions`	Write transition arrows with conditions
`calculate_blend_space_2d`	Generate 2D blend space for directional locomotion

Camera & Cinematic (3)

Tool	Description
`generate_bezier_camera_path`	Catmull-Rom bezier Path3D + PathFollow3D + Camera3D with tension control
`inject_lookat_tracking`	Generate LookAt tracking GDScript for Camera3D
`build_camera_switcher_timeline`	Write Animation that switches Camera3D.current at timestamps

NPR Materials & Shaders (2)

Tool	Description
`batch_shader_uniforms`	Bulk-override shader_parameter/* in all .tres files
`remap_texture_channels`	Wire textures into material property slots

Pipeline Automation (2)

Tool	Description
`toggle_movie_maker`	Edit project.godot to enable/disable Movie Maker mode
`run_headless_diagnostics`	Validate 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:

Subprocess bridge — core 14 tools invoke godot_operations.gd headlessly via subprocess.run()
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

Reviews

No reviews yet

Be the first to review this server!

4.8

Local

mcp-creator-python