Gear
đ MCP Server
đ Made with Godot
đ Node.js
đ TypeScript
đ npm
đ Stars
đ MIT License
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 gearOder global installieren:
npm install -g gear-godot-mcp
gear2) 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/projectsauf""Erstelle
scenes/Player.tscnmitCharacterBody2Dals Wurzelknoten""FĂŒhre das Projekt aus, rufe die Debug-Ausgabe ab und behebe den Fehler"
Related MCP server: godot-mcp-pilot
Warum Gear?
Kernvorteile
Merkmal | Beschreibung |
Echtzeit-Feedback | Spiel ausfĂŒhren, Logs prĂŒfen, sofort beheben |
110+ Tools | Deckt Szenen/Skripte/Ressourcen/Laufzeit/LSP/Debugging/Eingabe/Assets ab |
Token-effizient | StandardmĂ€Ăig nur 33 Kern-Tools, Aktivierung bei Bedarf |
Dynamische Tool-Gruppen | Automatische Aktivierung relevanter Gruppen bei der Suche |
Tiefe Integration | ClassDB-Abfragen, Laufzeit-Inspektion, Breakpoint-Debugging |
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:
Modus | Anzahl der Tools | Beschreibung |
| 33 Kern + 78 bei Bedarf | Token-effizient, Laden bei Bedarf |
| 110+ | Alle Tools exponiert |
| 110+ | Identisch mit |
Dynamische Tool-Gruppen im compact-Modus
Im compact-Modus sind 78 zusÀtzliche Tools in 22 dynamischen Tool-Gruppen organisiert:
Tool-Gruppe | Anzahl Tools | Beschreibung |
| 3 | Knoten duplizieren, neu parenten, Sprites laden |
| 4 | Laufzeit-Szeneninspektion, EigenschaftsÀnderungen |
| 6 | Breakpoints, Einzelschritt-AusfĂŒhrung, Stack-Traces |
| 3 | Code-VervollstÀndigung, Hover, Symbolliste |
| 6 | Screenshots, Eingabe-Injektion |
| 5 | Animationen, Tracks, Zustandsautomaten |
| 4 | Materialien, Shader, Ressourcenerstellung |
... | ... | Und mehr |
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 diedap-Gruppe zum Debuggen"
3. Deaktivierung
Verwende
tool.groups, um aktivierte Gruppen zurĂŒckzusetzen.
Installation
Methode A: npx (Empfohlen)
npx -y gearMethode B: Globale Installation
npm install -g gear-godot-mcp
gearMethode 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.jsFunktionsĂŒ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
Variable | Zweck | Standardwert |
| Tool-Expositionsmodus |
|
| Pfad zur Godot-Executable | Automatische Erkennung |
| Bridge-Service-Port |
|
| SeitengröĂe der Tool-Liste |
|
| Debug-Logs |
|
HĂ€ufig gestellte Fragen
Problem | Lösung |
Godot nicht gefunden |
|
Tool-Liste leer | MCP-Client neu starten |
Projektpfad ungĂŒltig | Sicherstellen, dass |
Laufzeit-Tools funktionieren nicht | Runtime-Addon-Plugin installieren und aktivieren |
Tool nicht gefunden |
|
Verwandte Links
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
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/wvfp/gear-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
