Skip to content
Back to search

gdai-mcp-plugin-godot

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/3ddelano--gdai-mcp-plugin-godot/badge.svg)](/listings/3ddelano--gdai-mcp-plugin-godot)

HTML

<a href="/listings/3ddelano--gdai-mcp-plugin-godot"><img src="/api/listings/3ddelano--gdai-mcp-plugin-godot/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 166 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. > gdai-mcp-plugin-godot
  2. # 🤖 GDAI MCP – MCP Server for Godot Game Engine
  3. **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.
  4. > 🔗 [Get the Plugin (https://gdaimcp.com)](https://gdaimcp.com) &nbsp;
  5. ---
  6. ## 🚀 Feature Highlights
  7. Take your Godot workflow to the next level by automating your game development.
  8. - **[NEW!] ✨ 📷 Automatically takes screenshots to visually understand the editor and running game.**
  9. - 🧱 **Create Scenes Programmatically**
  10. Generates scenes, nodes, resources, scripts and more
  11. - 🛠️ **Add & Manipulate Nodes**
  12. Modifies the scene tree adding/removing/updating nodes and their properties
  13. - 🐞 **Debugger Integration**
  14. View debugger output, logs and scripts errors.
  15. - 📁 **File & Asset Search**
  16. Searches for files and resources directly from the filesystem (`res://`)
  17. - 📐 **Property Updates**
  18. Set and get node properties dynamically.
  19. - 🧩 **Project Understanding**
  20. Has a deep understanding of your project, scenes and scripts.
  21. - 📝 **GDScript context**
  22. Helps you write and debug GDScript
  23. ---
  24. ## 🛠️ How It Works
  25. Use the GDAI MCP Plugin to control Godot from any MCP Client like Cursor, Windsurf, Claude, VSCode etc.
  26. 1. **Install in Godot Project**
  27. Add the GDAI MCP Plugin to your Godot project.
  28. [Installation Guide](https://gdaimcp.com/docs/installation)
  29. 2. **Add command in MCP Client**
  30. Add the MCP server command to your MCP Client's config.
  31. [MCP Client Config](https://gdaimcp.com/docs/installation#2-install-in-mcp-client)
  32. 3. **Start Chatting**
  33. Start chatting and see the MCP action!
  34. [Examples](https://gdaimcp.com/docs/examples)
  35. ---
  36. ## 💻 Example
  37. **User:** Please fix my gdscript errors.
  38. **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.
  39. Running tool: `get_open_script`
  40. Running tool: `get_open_script_errors`
  41. ...conversation continues
  42. See more examples at the end
  43. ---
  44. ## 🤝 Compatible MCP Clients
  45. Use GDAI MCP with your favorite MCP client or IDE:
  46. - Cursor
  47. - Claude Desktop
  48. - VS Code (via GitHub Copilot, Cline, Roo Code, etc)
  49. - WindSurf
  50. - And more
  51. ## 🤝 Compatible Godot version
  52. The plugin is compatible with `Godot 4.1+`
  53. ---
  54. ## ❓ Frequently Asked Questions
  55. **What is GDAI MCP Godot Plugin?**
  56. A plugin that allows any MCP Client to control Godot Engine Editor remotely, allowing it to create scenes, nodes, resources, scripts and more.
  57. **Can this make an entire game with one shot prompt?**
  58. 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.
  59. **Is Godot scripting experience required?**
  60. No, but it's helpful.
  61. **Which clients are supported?**
  62. Any MCP client either a program or even a script can connect to the MCP server.
  63. **Can I use this in commercial projects?**
  64. Yes! You can use this plugin to make commercial games!
  65. **Can I use this in a public project?**
  66. Yes! But make sure to not commit the plugin to the public repository of your game.
  67. **Is there documentation?**
  68. Yes, detailed docs are available.
  69. ---
  70. ## 🚀 Take Your Godot Workflow to the Next Level
  71. Unlock the full potential of AI through automated game development via the GDAI MCP Plugin.
  72. > [🔗 Get the plugin](https://gdaimcp.com)
  73. ---
  74. ### 🗣️ Suggestions
  75. ##### Have any question or feature requests?
  76. Join the [Discord Server](https://discord.gg/FZY9TqW) or DM `@3ddelano`
  77. ---
  78. ### 💡 More examples
  79. - 3D Minecraft clone
  80. [![3D Minecraft clone](http://img.youtube.com/vi/ybCBvvbGk5s/0.jpg)](https://youtube.com/shorts/ybCBvvbGk5s?si=XFcw_BINKK1A6RHQ)
  81. - 3D car racing game
  82. [![3D car racing game](http://img.youtube.com/vi/IeYTmrZOxcU/0.jpg)](https://youtube.com/shorts/IeYTmrZOxcU?si=WevMw8rrK-0t4rvy)
  83. - Create scene with nodes
  84. [![Create scene with nodes](http://img.youtube.com/vi/0dz1Nb1maco/0.jpg)](https://youtu.be/0dz1Nb1maco?si=KZoQm__Hx6NR9K5R)
  85. - Edit GDScript files
  86. [![Edit GDScript files](http://img.youtube.com/vi/oYev6V8u_Oo/0.jpg)](https://youtu.be/oYev6V8u_Oo?si=I1eehN-Tj6kTdCWo)
  87. ---
  88. ### Installation Guide
  89. Check out the detailed [Installation Guide](https://gdaimcp.com/docs/installation)
  90. ---
  91. ### 🔄 Update Guide
  92. Check out the detailed [Update Guide](https://gdaimcp.com/docs/update-guide)
  93. ---
  94. 🔗 [Get the Plugin](https://gdaimcp.com) &nbsp;
  95. ---
  96. 📄 [License](https://gdaimcp.com/license)
  97. © 2025 Delano Lourenco. All rights reserved.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.