Godot MCP

Godot MCP is an innovative server and plugin framework designed to seamlessly integrate AI assistance into the Godot game development environment. By utilizing compatible AI clients like Claude and Cursor, developers can now enjoy enhanced productivity without the hassle of constant context switching or tedious copy-pasting. This allows AI to directly read, write, and manipulate game elements such as scenes, scripts, nodes, and project settings.

Key Features

• Unleash AI Capabilities: Empower your AI assistant with full access to the Godot editor, facilitating streamlined game development processes.
• Comprehensive Toolset: The project includes 32 tools spread across 6 categories, enabling a wide range of operations:
  • File Operations: Browse directories, read files, search projects, and create scripts.
  • Scene Operations: Create scenes, manipulate nodes, set properties, and more.
  • Script Operations: Apply code edits, validate syntax, and manage file references.
  • Project Tools: Access project settings, manage input maps, and debug with ease.
  • Asset Generation: Generate 2D sprites from SVG files.
  • Visualization: Explore project structure through an interactive web-based visualizer.

Interactive Visualization

The tool offers an interactive browser-based visualization of the project that includes:

• A force-directed graph that shows all scripts and their interrelations.
• Real-time editing capabilities, allowing changes to be synchronized directly with Godot.
• A comprehensive scene view for easy navigation and property editing.

Architecture Overview

The architecture leverages a cloudless setup involving:

┌─────────────┐    MCP (stdio)    ┌─────────────┐   WebSocket    ┌──────────────┐
│  AI Client   │◄────────────────►│  MCP Server  │◄─────────────►│ Godot Editor │
│  (Claude,    │                  │  (Node.js)   │   port 6505   │  (Plugin)    │
│   Cursor)    │                  │              │               │              │
└─────────────┘                  │  Visualizer  │               │  32 tool     │
                                 │  HTTP :6510  │               │  handlers    │
                                 └──────┬───────┘               └──────────────┘
                                        │
                                 ┌──────▼───────┐
                                 │   Browser     │
                                 │  Visualizer   │
                                 └──────────────┘

Limitations

While the Godot MCP provides substantial capabilities, it currently operates under a few constraints:

• Local Only: The server runs exclusively on localhost.
• Single Connection: Only one instance of Godot can connect at a time.
• No Undo Feature: Changes made through the AI are saved immediately, necessitating version control for backup.
• AI Limitations: The AI cannot autonomously create complex UI elements or completely develop the game's structure but serves as an effective coding assistant and debug tool.

For detailed usage instructions, installation steps, and a comprehensive list of tools, refer to the complete documentation.

To get started, add the MCP server to your AI client and install the Godot plugin, empowering your AI to assist in evolving your games within the Godot engine.