Gear

Gear ermöglicht es KI-Assistenten, deine Godot-Projekte direkt auszuführen, zu untersuchen, zu ändern und zu debuggen.

Schnellstart (3 Minuten)

Systemanforderungen

• Godot 4.x

• Node.js 18+

• Ein MCP-kompatibler Client (Claude Desktop, Cursor, Cline, etc.)

1) Gear starten

npx -y gear

Oder global installieren:

npm install -g gear-godot-mcp
gear

2) MCP-Client konfigurieren

Füge dies zur Konfigurationsdatei deines Clients (z. B. Claude Desktop) hinzu:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "gear"],
      "env": {
        "GODOT_PATH": "/path/to/godot"
      }
    }
  }
}

3) Probiere diese Befehle aus

• "Liste alle Godot-Projekte im Verzeichnis /your/projects auf"

• "Erstelle scenes/Player.tscn mit CharacterBody2D als Wurzelknoten"

• "Führe das Projekt aus, rufe die Debug-Ausgabe ab und behebe den Fehler"

Related MCP server: Godot MCP Enhanced

Warum Gear?

Kernvorteile

Anwendungsfälle

• ✅ Indie-Entwickler, die KI zur Beschleunigung der Entwicklung nutzen

• ✅ Teams, die möchten, dass die KI den tatsächlichen Projekt-/Laufzeitstatus versteht

• ✅ Intensive Debugging-Workflows (Breakpoints, Stack-Traces, Laufzeit-Inspektion)

Tool-Nutzungsmodi

Tool-Expositionsstufen

Gear bietet drei Modi für die Tool-Exposition:

Dynamische Tool-Gruppen im compact-Modus

Im compact-Modus sind 78 zusätzliche Tools in 22 dynamischen Tool-Gruppen organisiert:

Verwendung von Tool-Gruppen

1. Automatische Aktivierung (Empfohlen)

Verwende tool.catalog, um nach relevanten Tools zu suchen; passende Gruppen werden automatisch aktiviert.

2. Manuelle Aktivierung

Verwende tool.groups, um spezifische Gruppen manuell zu aktivieren. "Aktiviere die dap-Gruppe zum Debuggen"

3. Deaktivierung

Verwende tool.groups, um aktivierte Gruppen zurückzusetzen.

Installation

Methode A: npx (Empfohlen)

npx -y gear

Methode B: Globale Installation

npm install -g gear-godot-mcp
gear

Methode C: Installation aus dem Quellcode

git clone https://github.com/HaD0Yun/Gear-godot-mcp.git
cd Gear-godot-mcp
npm install
npm run build
node build/index.js

Funktionsübersicht

Szenenbearbeitung

• Szenen erstellen, Knoten hinzufügen/löschen

• Knoteneigenschaften ändern

• Knoten neu parenten

Skript-Workflow

• Skripte erstellen/ändern

• Skriptstruktur analysieren

• Symbole umbenennen

Laufzeit-Debugging

• Laufzeit-Szenenbaum untersuchen

• Breakpoints setzen, Einzelschritt-Ausführung

• Variablenwerte anzeigen

Eingabe & Screenshots

• Tastatur-/Mauseingaben injizieren

• Spielbildschirm aufnehmen

• Viewport-Capture

Asset-Management

• CC0-Assets suchen (Poly Haven, AmbientCG, Kenney)

• Ressourcen ins Projekt herunterladen

Umgebungsvariablen

Häufig gestellte Fragen

Verwandte Links

• Architektur-Dokumentation

• Entwicklungs-Roadmap

• Changelog

• Beitrag-Leitfaden

Lizenz

MIT — siehe LICENSE für Details.

Danksagungen

• Ursprünglicher MCP-Server von Coding-Solo

• Gear-Erweiterungen entwickelt von HaD0Yun

• Projekt-Visualisierungsfunktionen inspiriert von tomyud1/godot-mcp