godot-mcp-pro  by youichi-uda

AI-assisted Godot game development SDK

Created 2 months ago
278 stars

Top 93.2% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

Godot MCP Pro provides an extensive toolkit for integrating AI assistants directly into the Godot 4 game development environment. It addresses the need for seamless AI-powered code generation, asset manipulation, and editor control, targeting Godot developers seeking to accelerate their workflow. The primary benefit is access to 172 specialized tools that enable AI models to interact with the Godot editor in real-time, covering a broad spectrum of development tasks from scene management to physics and animation.

How It Works

The system employs a Model Context Protocol (MCP) architecture, connecting AI assistants to the Godot editor via a Node.js server. Communication is facilitated through a persistent WebSocket connection for real-time feedback and JSON-RPC 2.0 for structured requests and responses. This approach grants the AI full access to Godot's editor API, including the UndoRedo system and the scene tree, enabling sophisticated, in-editor operations without manual file polling.

Quick Start & Requirements

  1. Install Godot Plugin: Copy the addons/godot_mcp/ folder into your Godot project's addons/ directory and enable the plugin via Project Settings.
  2. Install MCP Server: The server component is included in the paid package. Download and extract the provided zip, then navigate to the server/ directory and run npm install followed by npm run build.
  3. Configure AI Client: For clients like Claude, add the server configuration to your .mcp.json file, specifying the Node.js command and path to the built server script.

Highlighted Details

  • Offers a comprehensive suite of 172 tools, significantly exceeding competitors in scope and functionality.
  • Features exclusive tool categories not found in competing solutions, including extensive support for Animation, TileMap, Theme/UI, Profiling, Batch/Refactoring, Shader manipulation, Export processes, Physics configuration, 3D Scene setup, Particle systems, Navigation baking, Audio bus management, AnimationTree, State Machines, and Testing/QA.
  • The architecture boasts advantages like JSON-RPC 2.0, persistent WebSocket connections with auto-reconnect and heartbeat, robust Undo/Redo integration, and smart type parsing for common Godot data formats.
  • Includes a CLI mode for AI clients lacking MCP support or when minimizing context overhead is critical.

Licensing & Compatibility

The software is proprietary, with a one-time purchase granting lifetime updates. It is designed for compatibility with various AI assistants, including Claude, Cursor, VS Code Copilot, and others, offering different operational modes (Full, 3D, Lite, Minimal) to accommodate diverse tool count limitations imposed by AI clients.

Limitations & Caveats

The core Node.js MCP server is distributed exclusively as part of the paid package; the public repository only contains the free Godot plugin. Users may need to select specific operational modes or utilize the CLI if their AI client has strict tool count limitations. Setup requires familiarity with Node.js and npm for building the server component.

Health Check
Last Commit

1 week ago

Responsiveness

Inactive

Pull Requests (30d)
3
Issues (30d)
15
Star History
228 stars in the last 30 days

Explore Similar Projects

Starred by Guillermo Rauch Guillermo Rauch(Founder of Vercel), Jared Palmer Jared Palmer(SVP at GitHub; Founder of Turborepo; Author of Formik, TSDX), and
18 more.

ai by vercel

0.7%
24k
AI SDK for building AI-powered applications and agents
Created 2 years ago
Updated 6 hours ago
Feedback? Help us improve.