Godot MCP Server

A comprehensive Model Context Protocol (MCP) server for Godot Engine that enables AI assistants to interact with Godot projects. Provides powerful tools for project management, script execution, scene manipulation, asset management, and more.

Features

• 🚀 Project Management - Launch editor, run projects, manage multiple projects
• 📜 Script Management - Create, read, analyze GDScript with templates
• 🎬 Scene Management - List, inspect, create scenes
• 🔍 Node Operations - Find nodes, get properties
• 📊 Project Analysis - Statistics, unused assets detection
• 🎨 Asset Management - List images, audio, fonts
• ⚙️ Project Settings - Read project.godot configuration
• ✅ Validation - GDScript validation via LSP
• 📦 Export - Export to Windows, Linux, macOS, Android, Web
• 🔧 UID Management - Godot 4.4+ UID support

Requirements

• Node.js 18+
• Godot Engine 4.x (recommended)
• npm

Quick Start

# Clone and install
git clone https://github.com/godot-mcp/godot-mcp.git
cd godot-mcp
npm install
npm run build

Configuration

Environment Variables

Claude Desktop

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/path/to/godot-mcp/dist/index.js"],
      "env": {
        "GODOT_PATH": "/path/to/godot",
        "GODOT_PROJECT_PATH": "/path/to/project"
      }
    }
  }
}

Cline

See configs/cline_mcp_settings.json for full auto-approve list.

Cursor

Create .cursor/mcp.json in your project:

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/path/to/godot-mcp/dist/index.js"]
    }
  }
}

Available Tools (35+)

Project Management

Script Management

Scene Management

Node Operations

UID Management (Godot 4.4+)

Debug

Project Analysis

Asset Management

Project Settings

Validation

Export

Utility

Script Templates

When creating scripts, use the template parameter:

• basic - Basic Node script
• node - Node with @onready
• character - CharacterBody2D with movement
• resource - Custom Resource
• autoload - Autoload singleton
• state - State pattern

Example Prompts

"Launch the Godot editor for my project"
"Create a Player script with character template"
"Analyze my project and show statistics"
"Find all scenes in my project"
"Export my project for Windows"
"What scripts are in my project?"
"Get the scene tree of Main.tscn"

Development

npm run dev    # Development with hot reload
npm run build  # Build TypeScript
npm start      # Run production

Contributing

Contributions are welcome! Feel free to open issues or submit pull requests to help improve the project.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/my-feature)
3. Commit your changes (git commit -m 'Add my feature')
4. Push to the branch (git push origin feature/my-feature)
5. Open a Pull Request

License

MIT - See LICENSE