π€ GDAI MCP β MCP Server for Godot Game Engine
LocalAbout π€ GDAI MCP β MCP Server for Godot Game Engine
GDAI MCP is a Godot 4.1+ plugin that lets MCP clients such as Claude, Cursor and VS Code control the Godot Editor. It is aimed at game developers who want an assistant to create scenes and nodes, edit scripts, and read errors and debugger logs.
Key features
- 01Create scenes, nodes, resources and scripts in the editor
- 02Add, remove and update nodes and their properties
- 03Read script errors, debugger output and logs
- 04Search files and resources under res:// paths
- 05Take screenshots of the editor and running game
Use cases
- 01Having an AI assistant inspect and fix GDScript errors
- 02Generating scene structures and basic nodes from prompts
- 03Adjusting node properties across a Godot project
MCP support
The plugin runs as an MCP server that exposes tools for editing scenes, reading script errors and searching files in the Godot Editor to MCP clients.
Configuration
Local server config is the same for every client. Copy it into your clientβs MCP config file.
We havenβt collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEgdai-mcp-plugin-godot
π€ GDAI MCP β MCP Server for Godot Game Engine
GDAI MCP Godot Plugin allows AI to control the Godot Editor to create scenes, nodes, scripts. It can debug script errors, debugger and output logs.
π Feature Highlights
Take your Godot workflow to the next level by automating your game development.
-
[NEW!] β¨ π· Automatically takes screenshots to visually understand the editor and running game.
-
π§± Create Scenes Programmatically
Generates scenes, nodes, resources, scripts and more -
π οΈ Add & Manipulate Nodes
Modifies the scene tree adding/removing/updating nodes and their properties -
π Debugger Integration
View debugger output, logs and scripts errors. -
π File & Asset Search
Searches for files and resources directly from the filesystem (res://) -
π Property Updates
Set and get node properties dynamically. -
π§© Project Understanding
Has a deep understanding of your project, scenes and scripts. -
π GDScript context
Helps you write and debug GDScript
π οΈ How It Works
Use the GDAI MCP Plugin to control Godot from any MCP Client like Cursor, Windsurf, Claude, VSCode etc.
-
Install in Godot Project
Add the GDAI MCP Plugin to your Godot project.
Installation Guide -
Add command in MCP Client
Add the MCP server command to your MCP Client's config.
MCP Client Config -
Start Chatting
Start chatting and see the MCP action!
Examples
π» Example
User: Please fix my gdscript errors.
Assistant: I'd be happy to help fix your GDScript errors. Let me start by examining your current scene and looking for any errors in your script.
Running tool: get_open_script
Running tool: get_open_script_errors
...conversation continues
See more examples at the end
π€ Compatible MCP Clients
Use GDAI MCP with your favorite MCP client or IDE:
- Cursor
- Claude Desktop
- VS Code (via GitHub Copilot, Cline, Roo Code, etc)
- WindSurf
- And more
π€ Compatible Godot version
The plugin is compatible with Godot 4.1+
β Frequently Asked Questions
What is GDAI MCP Godot Plugin?
A plugin that allows any MCP Client to control Godot Engine Editor remotely, allowing it to create scenes, nodes, resources, scripts and more.
Can this make an entire game with one shot prompt?
Yes and no. It depends on the quality of your prompt and the LLM used. Claude Desktop most of the times is able to one-shot simple games.
Is Godot scripting experience required?
No, but it's helpful.
Which clients are supported?
Any MCP client either a program or even a script can connect to the MCP server.
Can I use this in commercial projects?
Yes! You can use this plugin to make commercial games!
Can I use this in a public project?
Yes! But make sure to not commit the plugin to the public repository of your game.
Is there documentation?
Yes, detailed docs are available.
π Take Your Godot Workflow to the Next Level
Unlock the full potential of AI through automated game development via the GDAI MCP Plugin.
π£οΈ Suggestions
Have any question or feature requests?
Join the Discord Server or DM @3ddelano
π‘ More examples
Installation Guide
Check out the detailed Installation Guide
π Update Guide
Check out the detailed Update Guide
π Get the Plugin Β
π License
Β© 2025 Delano Lourenco. All rights reserved.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.



