mirror of
https://gitlab.com/MaddoScientisto/cirnogodot.git
synced 2026-06-21 21:13:46 +00:00
124 lines
3.4 KiB
Markdown
124 lines
3.4 KiB
Markdown
|
> gdai-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.
|
|||
|
|
|
|||
|
|
> 🔗 [Get the Plugin](https://gdaimcp.com/)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🚀 Feature Highlights
|
|||
|
|
|
|||
|
|
Take your Godot workflow to the next level by automating your game development.
|
|||
|
|
|
|||
|
|
- 🧱 **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.
|
|||
|
|
|
|||
|
|
1. **Install in Godot Project**
|
|||
|
|
Add the GDAI MCP Plugin to your Godot project.
|
|||
|
|
[Installation Guide](https://gdaimcp.com/docs/installation)
|
|||
|
|
|
|||
|
|
2. **Add command in MCP Client**
|
|||
|
|
Add the MCP server command to your MCP Client's config.
|
|||
|
|
[MCP Client Config](https://gdaimcp.com/docs/installation#2-install-in-mcp-client)
|
|||
|
|
|
|||
|
|
3. **Start Chatting**
|
|||
|
|
Start chatting and see the MCP action!
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 💻 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
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🤝 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.2+`
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## ❓ 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.
|
|||
|
|
|
|||
|
|
> [🔗 Get the plugin](https://gdaimcp.com/)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
|
|||
|
|
### 🗣️ Suggestions
|
|||
|
|
|
|||
|
|
##### Have any question or feature requests?
|
|||
|
|
Join the [Discord Server](https://discord.gg/FZY9TqW) or DM `@3ddelano`
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
© 2025 Delano Lourenco. All rights reserved.
|