---
slug: "gdai-mcp-godot插件"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/3ddelano/gdai-mcp-plugin-godot@main/README.md"
repo: "https://github.com/3ddelano/gdai-mcp-plugin-godot"
source_file: "README.md"
branch: "main"
---
> 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)](https://gdaimcp.com)  

---

## 🚀 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.

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!  
   [Examples](https://gdaimcp.com/docs/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.

> [🔗 Get the plugin](https://gdaimcp.com)

---


### 🗣️ Suggestions

##### Have any question or feature requests?  
Join the [Discord Server](https://discord.gg/FZY9TqW) or DM `@3ddelano`

---

### 💡 More examples

- 3D Minecraft clone

  [![3D Minecraft clone](http://img.youtube.com/vi/ybCBvvbGk5s/0.jpg)](https://youtube.com/shorts/ybCBvvbGk5s?si=XFcw_BINKK1A6RHQ)
  
- 3D car racing game

  [![3D car racing game](http://img.youtube.com/vi/IeYTmrZOxcU/0.jpg)](https://youtube.com/shorts/IeYTmrZOxcU?si=WevMw8rrK-0t4rvy)

- Create scene with nodes

  [![Create scene with nodes](http://img.youtube.com/vi/0dz1Nb1maco/0.jpg)](https://youtu.be/0dz1Nb1maco?si=KZoQm__Hx6NR9K5R)

- Edit GDScript files

  [![Edit GDScript files](http://img.youtube.com/vi/oYev6V8u_Oo/0.jpg)](https://youtu.be/oYev6V8u_Oo?si=I1eehN-Tj6kTdCWo)

---

### Installation Guide

Check out the detailed [Installation Guide](https://gdaimcp.com/docs/installation)

---

### 🔄 Update Guide

Check out the detailed [Update Guide](https://gdaimcp.com/docs/update-guide)

---
🔗 [Get the Plugin](https://gdaimcp.com)  

---

📄 [License](https://gdaimcp.com/license)

© 2025 Delano Lourenco. All rights reserved.