This plugin provides a native Model Context Protocol (MCP) server within the Godot Engine, enabling AI assistants to directly interact with and modify Godot projects. It targets Godot Engine developers seeking to integrate AI for tasks like code generation, debugging, and scene manipulation, offering a powerful, dependency-free solution for enhanced productivity.

How It Works

The project implements the MCP specification natively within Godot using its HTTP capabilities, eliminating the need for external runtimes like Node.js. AI tools connect via HTTP to the Godot MCP server, allowing them to read and modify project assets—scripts, scenes, nodes, and resources—through natural language commands. This approach ensures a "ready to use out of the box" experience with deep, real-time project integration.

Quick Start & Requirements

• Installation: Recommended via Godot's AssetLib (search "Godot MCP Native"). Manual installation involves copying the addons/godot_mcp folder to your project's addons directory and enabling the plugin in Project Settings.
• Prerequisites: Godot Engine 4.x (4.5+ recommended). No additional dependencies are required due to its native implementation.
• Configuration: Enable the plugin and configure the HTTP transport mode (transport_mode = "http") and port (default 9080). Authentication (auth_enabled, auth_token) is recommended for security.
• AI Integration: Examples are provided for connecting with AI tools like Claude Desktop, Cursor, Trae, Cline, OpenCode, and Codex.
• Documentation: Detailed guides are available in the docs/current/ folder.

Highlighted Details

• Extensive Toolset: Offers 154 tools (30 core, 124 supplementary) for comprehensive management of nodes, scripts, scenes, editor functions, debugging, and project settings.
• Full Project Access: AI assistants can read and modify scripts, scenes, nodes, and resources directly within the Godot environment.
• Native Implementation: Runs entirely within Godot, avoiding external dependencies and simplifying setup.
• Real-time Editing: AI-driven suggestions and modifications can be applied instantly within the editor.

Maintenance & Community

This is a community-driven plugin, authored by yurineko73, and is not officially affiliated with Godot Engine or Anthropic. No specific community channels or detailed contribution information beyond the author are provided in the README.

Licensing & Compatibility

The project is licensed under the permissive MIT License, which generally allows for commercial use and integration into closed-source projects.

Limitations & Caveats

As a community plugin, it lacks official support. Secure remote access requires careful configuration, including enabling authentication and potentially using HTTPS, as HTTP is the default transport mode. Functionality is dependent on the correct integration with compatible AI tools.