Godot AI

v1.0.0Browser Automationstable

Production-grade MCP server and AI tools for the Godot engine. A Snap to install. Totally free and fun.

aigame-developmentgodotgodot-pluginmcp
Share:
331
Stars
0
Downloads
0
Weekly
0/5

What is Godot AI?

Godot AI is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to production-grade mcp server and ai tools for the godot engine. a snap to install. totally free and fun.

Production-grade MCP server and AI tools for the Godot engine. A Snap to install. Totally free and fun.

This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Production-grade MCP server and AI tools for the Godot engin

Use Cases

Production-grade Godot MCP server
Game development with AI
Snap installation support
hi-godot

Maintainer

LicenseMIT
Languagegdscript
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx godot-ai

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Godot AI

Godot AI is a production-grade MCP server plugin for the Godot 4 game engine that exposes over 120 operations across approximately 41 MCP tools, allowing AI assistants to directly create and edit scenes, wire signals, manage materials and animations, and search project files. By installing the plugin inside Godot and connecting any MCP-compatible client (Claude Code, Codex, and 16+ others) to its local HTTP server at port 8000, developers can describe gameplay mechanics or scene structures in plain language and have the AI implement them inside the running Godot editor. It is entirely free and designed for both solo developers and teams who want AI-accelerated game development.

Prerequisites

  • Godot 4.3 or higher (4.4+ recommended)
  • uv package manager for the Python MCP server component (install via: curl -LsSf https://astral.sh/uv/install.sh | sh)
  • An MCP client such as Claude Code, Codex, or any client that supports HTTP/SSE transport
  • Git for cloning the plugin repository or access to the Godot Asset Library
1

Install the Godot AI plugin

Clone the repository and copy the plugin folder into your Godot project's addons directory. Alternatively, search for 'Godot AI' in the AssetLib tab inside the Godot editor and click Install.

git clone https://github.com/hi-godot/godot-ai.git
cp -r godot-ai/plugin/addons/godot_ai your-project/addons/
2

Enable the plugin inside Godot

Open your project in Godot, go to Project → Project Settings → Plugins, and activate the Godot AI plugin. The MCP HTTP server will start on port 8000 when the plugin is enabled.

3

Install uv for the Python server component

The plugin's MCP server backend requires uv. Install it with the command below (macOS/Linux). Windows users can use PowerShell: irm https://astral.sh/uv/install.ps1 | iex

curl -LsSf https://astral.sh/uv/install.sh | sh
4

Connect your MCP client to the Godot AI server

For Claude Code, register the server using its HTTP endpoint. The plugin serves the MCP API at http://127.0.0.1:8000/mcp.

claude mcp add --scope user --transport http godot-ai http://127.0.0.1:8000/mcp
5

Verify the connection

In your MCP client, ask it to list the scene hierarchy. If the plugin is active and Godot is open, you should receive a live response describing the current scene tree.

Godot AI Examples

Client configuration

Godot AI uses HTTP transport rather than stdio. Add this entry to your claude_desktop_config.json to connect to the Godot editor's local MCP endpoint.

{
  "mcpServers": {
    "godot-ai": {
      "command": "npx",
      "args": ["godot-ai"],
      "env": {}
    }
  }
}

Prompts to try

These prompts demonstrate Godot AI's ability to create and manipulate scenes, nodes, and project assets directly inside the running Godot editor.

- "Show me the current scene hierarchy"
- "Create a Camera3D named MainCamera under the /Main node"
- "Search the project for all PackedScene files in the ui/ folder"
- "Add a DirectionalLight3D to the root scene and set its rotation to 45 degrees on the X axis"
- "Build a simple voxel block-world game with a player controller and basic block placement"

Troubleshooting Godot AI

MCP client cannot connect to http://127.0.0.1:8000/mcp

Ensure Godot is open and the Godot AI plugin is enabled in Project → Project Settings → Plugins. The HTTP server only runs while the plugin is active and Godot is running.

Plugin does not appear in the Godot Plugin settings

Confirm the addons/godot_ai folder was copied into your Godot project directory (not a parent directory). The folder structure must be <your-project>/addons/godot_ai/. After copying, restart Godot.

uv or uvx not found when the server tries to start

Run `which uvx` in your terminal. If missing, install uv and restart your terminal or IDE so the updated PATH takes effect. On macOS you may also need to run `source ~/.zshrc`.

Frequently Asked Questions about Godot AI

What is Godot AI?

Godot AI is a Model Context Protocol (MCP) server that production-grade mcp server and ai tools for the godot engine. a snap to install. totally free and fun. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Godot AI?

Follow the installation instructions on the Godot AI GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Godot AI?

Godot AI works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Godot AI free to use?

Yes, Godot AI is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Browser Automation MCP Servers

Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "godot-ai": { "command": "npx", "args": ["-y", "godot-ai"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Godot AI?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides