Godot

Godot MCP Server provides an MCP-based integration that lets you control Godot projects with AI-assisted workflows. It enables automated code generation, scene management, and project operations through a standardized Model Context Protocol, making it easier to build, test, and iterate on Godot projects with AI partners and tools.

How to use

You interact with the Godot MCP Server through an MCP client. The server exposes a set of tools that can create and modify nodes, edit scripts, manage scenes, and orchestrate complex development tasks. Your goal is to describe what you want to achieve in natural language, and the MCP client coordinates the appropriate MCP tools to execute the steps, validate results, and report back progress.

How to install

Prerequisites: you need Node.js 18 or newer, npm, Git, and Godot 4.x installed on your system.

Concrete steps to get started are below. Choose the path that matches your environment.

# Linux/macOS: one-click setup (recommended for beginners)
git clone https://github.com/hhhh124hhhh/godot-mcp.git
cd godot-mcp
./setup-mcp-tools.sh

# Windows: one-click setup
git clone https://github.com/hhhh124hhhh/godot-mcp.git
cd godot-mcp
setup-mcp-tools.bat

# If you prefer manual steps, continue here

# 1. Clone the repository
# 2. Install Godot engine (4.2+ recommended)
# 3. Build the MCP server
cd server
npm install
npm run build

# 4. Return to project root for configuration
cd ..

Configuration and usage notes

Configure Claude Desktop or your MCP client to connect to the Godot MCP Server via a standard stdio channel. Use the following configuration snippet to start the local server for MCP integration.

{
  "mcpServers": {
    "godot-mcp": {
      "command": "node",
      "args": [
        "PATH_TO_YOUR_PROJECT/server/dist/index.js"
      ],
      "env": {
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

Available tools

detect_godot_version

Detects the project Godot version and configuration to tailor compatibility and migration guidance.

check_godot_api_compatibility

Scans GDScript for API compatibility issues against a target Godot version and reports problems.

fix_godot_api_compatibility

Automatically fixes common API compatibility issues across Godot 3.x to 4.x migrations.

get_godot_migration_advice

Provides detailed migration advice and example code for upgrading Godot projects between major versions.

节点操作工具

Operations for scene graph: get-scene-tree, get-node-properties, create-node, delete-node, modify-node.

脚本编辑工具

Script management: list-project-scripts, read-script, modify-script, create-script, analyze-script.

场景管理工具

Manage scenes: list-project-scenes, read-scene, create-scene, save-scene.

项目管理工具

Project-level utilities: get-project-settings, list-project-resources, get-project-info.

Chrome DevTools MCP

Web-based debugging and performance analysis via Chrome DevTools MCP integration.

Sequential Thinking MCP

Structured reasoning to decompose tasks and coordinate multiple tools.

Context7 MCP

Access to up-to-date library documentation and API references for rapid research.

中文开发指南技能

Complete Chinese development environment guidance and localization support.