Godot

Godot MCP Server is an AI-powered development assistant for the Godot game engine. It analyzes your project structure, helps diagnose errors and performance issues, and generates Godot-style code templates to accelerate your workflow. Use it with an MCP client to get intelligent insights, rapid scaffolding, and actionable optimization suggestions for your Godot projects.

How to use

You can run Godot MCP Server directly with an MCP client using a lightweight, zero-install approach via npx. This lets you start analyzing your Godot project and generate templates without manually setting up a server.

To use it with an MCP client, start with a local stdio configuration that runs the MCP tool and points to your Godot project directory. A typical setup is to launch the MCP runtime as a child process from the client, passing your project path so the assistant can inspect scenes, scripts, and configurations.

If you prefer a centralized workflow, you can also run the MCP server as a global package and connect the client to the resulting process. The server exposes its capabilities through a standard MCP interface so your client can request project information, generate templates, analyze scripts, and receive optimization recommendations.

How to install

Prerequisites you need before installing: a modern Node.js runtime and npm or npx available in your shell. Ensure Node.js is installed on your system, which also provides npm for package management.

# Option A: Run directly with npx (no installation required)
npx kooix-godot-mcp --project /path/to/your/godot/project

# Option B: Global installation via npm (recommended for CLI access)
npm install -g kooix-godot-mcp

# Then configure your MCP client to run the server with the project path

Additional configuration and setup notes

If you use a Claude Desktop or another MCP client, you can configure a local stdio server so the client launches the MCP tool with your project path. The following configuration runs the MCP tool via npx and passes the project directory as an argument.

{
  "mcpServers": {
    "godot-mcp": {
      "command": "npx",
      "args": ["kooix-godot-mcp", "--project", "/path/to/your/godot/project"]
    }
  }
}

Available tools

get-project-info

Extracts project configuration and metadata to understand project structure and setup.

list-scenes

Analyzes Godot scene files to map node hierarchies and scene relationships.

analyze-scene

Performs deep analysis of a specific scene file to surface issues and patterns.

list-scripts

Inventories all GDScript files for organization and refactoring work.

analyze-script

Parses script structure to identify methods, properties, and signals for quality and optimization.

generate-script-template

Generates common script templates and patterns that follow Godot conventions.

analyze-game-architecture

Provides high-level architectural analysis to assist system design.

generate-ui-component

Creates UI component templates such as menus, dialogs, and HUD elements.

optimize-game-performance

Offers performance analysis and actionable optimization suggestions.

generate-network-system

Provides networking code templates for multiplayer development.

debug-project-errors

Analyzes error logs and crash reports to propose fixes.

start-debug-session

Runs a real-time debugging session for interactive problem solving.

analyze-debug-logs

Parses log files for post-mortem analysis and troubleshooting.

get-performance-insights

Profiles performance and provides metrics to guide optimization.

check-project-health

Assesses overall project quality for maintenance and planning.