Godot Catalyst

The most comprehensive MCP server for AI-powered Godot 4.x game development. 240+ tools across 36 categories — more than any other Godot MCP.

Works with any MCP client: Claude Code, Cursor, Windsurf, Copilot, Cline, and more.

Why Godot Catalyst?

Quick Start

# One-command install
npx godot-catalyst --install-addon /path/to/your/godot-project

Or manually:

git clone https://github.com/shameindemgg/godot-catalyst.git
cd godot-catalyst && npm install && npm run build

Architecture

AI Agent  <--stdio-->  TypeScript MCP Server  <--WebSocket:6505-->  Godot EditorPlugin
                              |
                       TCP:6005 (LSP)
                       TCP:6006 (DAP)

• MCP Server (TypeScript/Node.js) — Exposes 240+ tools via the MCP protocol over stdio
• Godot Plugin (GDScript) — Runs inside the Godot editor, receives commands over WebSocket
• LSP Client — Connects to Godot's built-in GDScript Language Server for code intelligence
• DAP Client — Connects to Godot's built-in Debug Adapter for debugging

Features

240+ Tools across 36 categories

Dynamic Tool Modes

Not all MCP clients support 240+ tools. Use GODOT_TOOL_MODE to control which tools are registered:

Setup

Prerequisites

• Node.js >= 18
• Godot 4.x editor

1. Install

Option A: npx (recommended)

npx godot-catalyst --install-addon /path/to/your/godot-project

Option B: Clone

git clone https://github.com/shameindemgg/godot-catalyst.git
cd godot-catalyst
npm install && npm run build

Then copy godot-plugin/addons/godot_catalyst/ into your Godot project's addons/ folder.

2. Enable the Plugin

Open your Godot project, go to Project > Project Settings > Plugins, enable Godot Catalyst.

3. Configure Your MCP Client

Add the server to your MCP client's configuration. Examples for popular clients:

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

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

4. Enable LSP/DAP (optional)

For code intelligence and debugging tools, enable in Godot:

• Editor > Editor Settings > Network > Language Server > Enable (port 6005)
• Editor > Editor Settings > Network > Debug Adapter > Enable (port 6006)

Environment Variables

Development

npm run build    # Compile TypeScript
npm run dev      # Watch mode
npm test         # Run tests
npm start        # Start the MCP server

Testing

Tests use Node.js built-in test runner:

npm test

Tests cover the offline file parsers (TSCN, TRES, project.godot) which can run without a Godot instance.

License

Proprietary — see LICENSE for details. The Godot editor plugin (godot-plugin/) is MIT-licensed.