Godot MCP Server

An MCP (Model Context Protocol) server that provides tools for Godot Engine development.

Features

• godot_run_tests - Run GUT (Godot Unit Test) tests and get structured results

• godot_check_errors - Check for parse/syntax errors without running the game

• godot_import - Import/reimport assets

• godot_run_scene - Run a specific scene

• godot_export - Export project to a platform

Installation

cd mcp/godot-mcp
uv pip install -e .

Or with pip:

pip install -e mcp/godot-mcp

Configuration

Add to your Claude Code MCP configuration (~/.claude/mcp.json):

{
  "mcpServers": {
    "godot": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp/godot-mcp", "godot-mcp"],
      "env": {
        "QT_QPA_PLATFORM": "xcb",
        "__GLX_VENDOR_LIBRARY_NAME": "mesa"
      }
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "godot": {
      "command": "godot-mcp"
    }
  }
}

Usage

Once configured, Claude Code can use these tools:

Run Tests

Use godot_run_tests to run the unit tests

Check for Errors

Use godot_check_errors to check for parse errors

Run a Scene

Use godot_run_scene to run the game

Requirements

• Python 3.10+

• Godot 4.x installed and in PATH

• GUT (Godot Unit Test) addon for test functionality

License

MIT