πŸ€– GDAI MCP – MCP Server for Godot Game Engine

by 3ddelano

93 stars
1k downloads
Not rated
GitHub Website

About

A MCP server integration for Godot Engine that allows Claude, Cursor, Windsurf, VSCode, etc to perform actions like creating scenes, resources, scripts, reading errors and much more.

Details

Author
3ddelano
GitHub stars
93
Downloads
1,023
Categories
Developer Tools

- Automatically takes screenshots to understand the editor and running game.
- Creates scenes, nodes, resources, and scripts programmatically.
- Modifies the scene tree and node properties.
- Integrates with the debugger to view logs and script errors.
- Searches files and assets from the res:// filesystem.
- Provides GDScript context for writing and debugging scripts.

Install the plugin in your Godot project (Godot 4.1+), then add the MCP server command to your MCP client’s configuration (e.g., Cursor, Claude Desktop, VS Code). Start chatting with the AI to control the editor.

πŸ€– 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.

- [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

2. Add command in MCP Client
Add the MCP server command to your MCP Client's config.
MCP Client Config

3. 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.

> πŸ”— Get the plugin

---

πŸ—£οΈ Suggestions

Have any question or feature requests?
Join the Discord Server or DM @3ddelano

---

πŸ’‘ More examples

- 3D Minecraft clone

3D Minecraft clone

- 3D car racing game

3D car racing game

- Create scene with nodes

Create scene with nodes

- Edit GDScript files

Edit GDScript files

---

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.

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.