Godot

Godot

An MCP server providing comprehensive Godot engine integration for project editing, debugging, and scene management.

1,122
Stars
133
Forks
0
Releases

Overview

Godot MCP is a Model Context Protocol (MCP) server that bridges the Godot game engine with AI assistants. It provides a standardized interface to launch the Godot editor for a project, run projects in debug mode, capture logs and errors, and control execution programmatically. This enables AI tools to inspect, modify, and debug Godot projects through natural prompts, improving code generation and debugging feedback. The server uses a two-tier architecture: direct commands leverage Godot's built-in CLI for simple tasks, while complex operations are handled by a bundled GDScript file (godot_operations.gd) that performs scene creation, node manipulation, texture loading, and export tasks. The design avoids creating temporary scripts, centralizes operations, and offers consistent error handling. Interactions are JSON-based, allowing flexible parameterization, and the server can be driven via environment variables (GODOT_PATH, DEBUG) or MCP-compatible clients (Cline, Cursor). Scene management capabilities include creating scenes with root node types, adding nodes with properties, loading Sprite2D textures, exporting 3D scenes as MeshLibrary for GridMap, and saving variants. Additional UID management functions for Godot 4.4+ enable UID retrieval and automatic reference updates.

Details

Owner
Coding-Solo
Language
JavaScript
License
MIT License
Updated
2025-12-07

Features

Launch Godot Editor

Open the Godot editor for a specific project.

Run Godot Projects

Execute Godot projects in debug mode.

Capture Debug Output

Retrieve console output and error messages.

Control Execution

Start and stop Godot projects programmatically.

Get Godot Version

Retrieve the installed Godot version.

List Godot Projects

Find Godot projects in a specified directory.

Scene Management

Create scenes with root nodes, add nodes with properties, load textures into Sprite2D, export MeshLibrary for GridMap, and save variants.

UID Management (Godot 4.4+)

Get UID for specific files and update UID references by resaving resources.

Audience

AI assistantsInteract with Godot projects by launching, running, debugging, and managing scenes through MCP.
Godot developersAutomate project analysis and scene workflows via MCP integration.
IDE integrationsIntegrate MCP with editors/agents to control Godot project workflows.

Tags

GodotMCPGodot EngineAI AssistantsScene ManagementAutomationMeshLibraryUID ManagementEditor LaunchDebuggingNode.jsTypeScript