A Model Context Protocol (MCP) server for interacting with the Godot game engine. Godot MCP enables AI assistants to launch the Godot editor, run projects, capture debug output, and control project execution - all through a standardized interface. This direct feedback loop helps AI assistants like Claude understand what works and what doesn't in real Godot projects, leading to better code generati
Add this skill
npx mdskills install Coding-Solo/godot-mcpComprehensive Godot Engine integration with extensive scene management and debugging tools
12# Godot MCP34[](https://github.com/sponsors/Coding-Solo)56[](https://modelcontextprotocol.io/introduction)7[](https://godotengine.org)8[](https://nodejs.org/en/download/)9[](https://www.typescriptlang.org/)1011[](https://github.com/Coding-Solo/godot-mcp/commits/main)12[](https://github.com/Coding-Solo/godot-mcp/stargazers)13[](https://github.com/Coding-Solo/godot-mcp/network/members)14[](https://opensource.org/licenses/MIT)1516```text17 ((((((( (((((((18 ((((((((((( (((((((((((19 ((((((((((((( (((((((((((((20 (((((((((((((((((((((((((((((((((21 (((((((((((((((((((((((((((((((((22 ((((( ((((((((((((((((((((((((((((((((((((((((( (((((23 (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((24 ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((25 ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((26 (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((27 (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((28 (((((((((((@@@@@@@(((((((((((((((((((((((((((@@@@@@@(((((((((((29 (((((((((@@@@,,,,,@@@(((((((((((((((((((((@@@,,,,,@@@@(((((((((30 ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((31 ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((32 (((((((((@@@,,,,,,,@@((((((((@@@@@((((((((@@,,,,,,,@@@(((((((((33 ((((((((((((@@@@@@(((((((((((@@@@@(((((((((((@@@@@@((((((((((((34 (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((35 (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((36 @@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@37 ((((((((( @@@(((((((((((@@(((((((((((@@(((((((((((@@@ (((((((((38 (((((((((( @@((((((((((@@@(((((((((((@@@((((((((((@@ ((((((((((39 (((((((((((@@@@@@@@@@@@@@(((((((((((@@@@@@@@@@@@@@(((((((((((40 (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((41 (((((((((((((((((((((((((((((((((((((((((((((((((((((42 (((((((((((((((((((((((((((((((((((((((((((((((43 (((((((((((((((((((((((((((((((((444546 /$$ /$$ /$$$$$$ /$$$$$$$47 | $$$ /$$$ /$$__ $$| $$__ $$48 | $$$$ /$$$$| $$ \__/| $$ \ $$49 | $$ $$/$$ $$| $$ | $$$$$$$/50 | $$ $$$| $$| $$ | $$____/51 | $$\ $ | $$| $$ $$| $$52 | $$ \/ | $$| $$$$$$/| $$53 |__/ |__/ \______/ |__/54```5556A Model Context Protocol (MCP) server for interacting with the Godot game engine.5758## Introduction5960Godot MCP enables AI assistants to launch the Godot editor, run projects, capture debug output, and control project execution - all through a standardized interface.6162This direct feedback loop helps AI assistants like Claude understand what works and what doesn't in real Godot projects, leading to better code generation and debugging assistance.6364## Features6566- **Launch Godot Editor**: Open the Godot editor for a specific project67- **Run Godot Projects**: Execute Godot projects in debug mode68- **Capture Debug Output**: Retrieve console output and error messages69- **Control Execution**: Start and stop Godot projects programmatically70- **Get Godot Version**: Retrieve the installed Godot version71- **List Godot Projects**: Find Godot projects in a specified directory72- **Project Analysis**: Get detailed information about project structure73- **Scene Management**:74 - Create new scenes with specified root node types75 - Add nodes to existing scenes with customizable properties76 - Load sprites and textures into Sprite2D nodes77 - Export 3D scenes as MeshLibrary resources for GridMap78 - Save scenes with options for creating variants79- **UID Management** (for Godot 4.4+):80 - Get UID for specific files81 - Update UID references by resaving resources8283## Requirements8485- [Godot Engine](https://godotengine.org/download) installed on your system86- Node.js and npm87- An AI assistant that supports MCP (Cline, Cursor, etc.)8889## Installation and Configuration9091### Step 1: Install and Build9293First, clone the repository and build the MCP server:9495```bash96git clone https://github.com/Coding-Solo/godot-mcp.git97cd godot-mcp98npm install99npm run build100```101102### Step 2: Configure with Your AI Assistant103104#### Option A: Configure with Cline105106Add to your Cline MCP settings file (`~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`):107108```json109{110 "mcpServers": {111 "godot": {112 "command": "node",113 "args": ["/absolute/path/to/godot-mcp/build/index.js"],114 "env": {115 "DEBUG": "true" // Optional: Enable detailed logging116 },117 "disabled": false,118 "autoApprove": [119 "launch_editor",120 "run_project",121 "get_debug_output",122 "stop_project",123 "get_godot_version",124 "list_projects",125 "get_project_info",126 "create_scene",127 "add_node",128 "load_sprite",129 "export_mesh_library",130 "save_scene",131 "get_uid",132 "update_project_uids"133 ]134 }135 }136}137```138139#### Option B: Configure with Cursor140141**Using the Cursor UI:**1421431. Go to **Cursor Settings** > **Features** > **MCP**1442. Click on the **+ Add New MCP Server** button1453. Fill out the form:146 - Name: `godot` (or any name you prefer)147 - Type: `command`148 - Command: `node /absolute/path/to/godot-mcp/build/index.js`1494. Click "Add"1505. You may need to press the refresh button in the top right corner of the MCP server card to populate the tool list151152**Using Project-Specific Configuration:**153154Create a file at `.cursor/mcp.json` in your project directory with the following content:155156```json157{158 "mcpServers": {159 "godot": {160 "command": "node",161 "args": ["/absolute/path/to/godot-mcp/build/index.js"],162 "env": {163 "DEBUG": "true" // Enable detailed logging164 }165 }166 }167}168```169170### Step 3: Optional Environment Variables171172You can customize the server behavior with these environment variables:173174- `GODOT_PATH`: Path to the Godot executable (overrides automatic detection)175- `DEBUG`: Set to "true" to enable detailed server-side debug logging176177## Example Prompts178179Once configured, your AI assistant will automatically run the MCP server when needed. You can use prompts like:180181```text182"Launch the Godot editor for my project at /path/to/project"183184"Run my Godot project and show me any errors"185186"Get information about my Godot project structure"187188"Analyze my Godot project structure and suggest improvements"189190"Help me debug this error in my Godot project: [paste error]"191192"Write a GDScript for a character controller with double jump and wall sliding"193194"Create a new scene with a Player node in my Godot project"195196"Add a Sprite2D node to my player scene and load the character texture"197198"Export my 3D models as a MeshLibrary for use with GridMap"199200"Create a UI scene with buttons and labels for my game's main menu"201202"Get the UID for a specific script file in my Godot 4.4 project"203204"Update UID references in my Godot project after upgrading to 4.4"205```206207## Implementation Details208209### Architecture210211The Godot MCP server uses a bundled GDScript approach for complex operations:2122131. **Direct Commands**: Simple operations like launching the editor or getting project info use Godot's built-in CLI commands directly.2142. **Bundled Operations Script**: Complex operations like creating scenes or adding nodes use a single, comprehensive GDScript file (`godot_operations.gd`) that handles all operations.215216This architecture provides several benefits:217218- **No Temporary Files**: Eliminates the need for temporary script files, keeping your system clean219- **Simplified Codebase**: Centralizes all Godot operations in one (somewhat) organized file220- **Better Maintainability**: Makes it easier to add new operations or modify existing ones221- **Improved Error Handling**: Provides consistent error reporting across all operations222- **Reduced Overhead**: Minimizes file I/O operations for better performance223224The bundled script accepts operation type and parameters as JSON, allowing for flexible and dynamic operation execution without generating temporary files for each operation.225226## Troubleshooting227228- **Godot Not Found**: Set the GODOT_PATH environment variable to your Godot executable229- **Connection Issues**: Ensure the server is running and restart your AI assistant230- **Invalid Project Path**: Ensure the path points to a directory containing a project.godot file231- **Build Issues**: Make sure all dependencies are installed by running `npm install`232- **For Cursor Specifically**:233- Ensure the MCP server shows up and is enabled in Cursor settings (Settings > MCP)234- MCP tools can only be run using the Agent chat profile (Cursor Pro or Business subscription)235- Use "Yolo Mode" to automatically run MCP tool requests236237## License238239This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.240241[](https://mseep.ai/app/coding-solo-godot-mcp)242
Full transparency — inspect the skill content before installing.