Sandbox
@3ddelano/gdai-mcp-plugin-godot

MCP server plugin for Godot Editor control

GDAI MCP is a Godot plugin that exposes editor actions through MCP so an AI client can work on your project. It supports scene and node creation, resource and script editing, debugger output, script errors, file search, and screenshots for visual context.

98 stars4 forksGDScriptUpdated 5mo ago
Vibe coding minecraft in Godot with GDAI MCP server and Claude #claude #vibecoding #gamedev
Delano Lourenco3.5k views • 1 year ago

Videos about this repo

Who it's for

Builders who want Claude, Cursor, Windsurf, or another MCP client to operate on a Godot project.

What it delivers

You can have an agent create and update Godot scenes and scripts while checking errors and logs in context.

What it does

Create scenes and resources

Generates scenes, nodes, resources, scripts, and other project content from MCP actions.

Edit scene trees

Adds, removes, and updates nodes and their properties in the current scene tree.

Read debugger output and script errors

Surfaces debugger logs, output, and GDScript errors to the connected client.

Search the project filesystem

Finds files and resources directly under `res://`.

Capture screenshots

Takes screenshots so the client can inspect the editor and running game visually.

Work with GDScript context

Helps the client write and debug GDScript inside the project.

README

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.

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

Files in the repo

Repository payload3 top-level entries
  • project
  • latest_version.txt
  • README.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More connectors

High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.

43k

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code

14k
okf-memory/
okf-agent-memory

Git-native persistent memory for AI coding agents. Implements Google OKF v0.2 with sub-300µs in-memory BM25 search, embedded MCP server, and progressive disclosure. Slashes token bloat by 80% with zero external databases or dependencies. Built in pure Go.

547
tirth8205/
code-review-graph

Local-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked context reductions on reviews and large-repo workflows.

31k
2akouwu/
reverify

Stop your AI from making things up — it proposes, deterministic tools decide, every claim checked against ground truth with evidence. Grounded facts and context survive resets. Reverse engineering is the proving ground. MCP server + CLI.

1.1k
t8y2/dbxConnectors

20 MB lightweight cross-platform database client for 90+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 90+ 数据库,提供桌面端、Docker、CLI、内置 AI 助手和 MCP Server。

19k