Wick

Roslyn-angereicherte C#-Ausnahme-Telemetrie für die Godot Engine, bereitgestellt über MCP.

👁 CI
👁 Lizenz: MIT

Was ist Wick?

Wenn ein Godot C#-Spiel abstürzt, sieht Ihr KI-Assistent einen rohen Stack-Trace und verbringt 8+ Runden damit, Sie zum Öffnen von Dateien aufzufordern. Wick erfasst diese Ausnahme, reichert sie mit Roslyn-basiertem Quellkontext an (dem tatsächlichen Methodenkörper, der Aufruferkette, aktuellen Protokollen, Szenenstatus) und übergibt das vollständige Bild in einem einzigen Aufruf an die KI. Eine Runde zur Diagnose statt zehn.

Was macht Wick anders?

Andere Godot MCP-Server (wie das exzellente GoPeak) konzentrieren sich auf Szenenmanipulation und GDScript-Tools. Wick konzentriert sich auf die C#/.NET-Entwicklererfahrung:

• Roslyn-angereicherte Ausnahme-Telemetrie -- über stderr erfasste C#-Ausnahmen, angereichert mit dem aufrufenden Methodenkörper, umgebenden Quellzeilen, umschließendem Typ und Aufruferkette. Kein anderer Godot MCP-Server bietet dies.

• In-Process-Ausnahmeerfassung -- optionaler Wick.Runtime NuGet-Begleiter fängt TaskScheduler.UnobservedTaskException und asynchrone Ausnahmen ab, die stderr nicht sehen kann.

• Build-Diagnose mit Quellkontext -- dotnet build-Fehler, angereichert mit Roslyn-Quellkontext über dieselbe Pipeline wie Laufzeitausnahmen.

• C#-Analysetools -- Symbolsuche, Referenzsuche, Mitgliedssignaturen über den Roslyn-Arbeitsbereich.

• 5-Säulen-Toolgruppensystem -- aktivieren Sie nur, was Sie benötigen: core, runtime, csharp, build, scene.

Related MCP server: GodotIQ

Erste Schritte

Voraussetzungen

• .NET 10 SDK (10.0.201 oder neuer)

• Godot 4.6.1+ mit .NET/Mono-Unterstützung

Installation

Wick besteht aus zwei Teilen: einem Godot-seitigen Bridge-Addon (/addons/wick/) und dem .NET MCP-Server.

Godot-Bridge — Installation über die Godot Asset Library im Editor (empfohlen) oder manuelles Kopieren von /addons/wick/ in Ihr Projekt.

MCP-Server — klonen und bauen:

git clone https://github.com/buildepicshit/Wick.git
cd Wick
dotnet build Wick.slnx --configuration Release -maxcpucount:1

MCP-Konfiguration

Fügen Sie Wick zur MCP-Konfiguration Ihres KI-Coding-Assistenten hinzu:

{
 "mcpServers": {
 "wick": {
 "command": "dotnet",
 "args": ["run", "--project", "path/to/Wick/src/Wick.Server"],
 "env": {
 "WICK_GROUPS": "core,runtime,csharp,build",
 "WICK_GODOT_BIN": "/path/to/godot",
 "WICK_PROJECT_PATH": "/path/to/your/godot-project"
 }
 }
 }
}

Tool-Gruppen

Aktivieren Sie Tool-Säulen über die Umgebungsvariable WICK_GROUPS oder das CLI-Flag --groups:

Beispiel: WICK_GROUPS=core,runtime,csharp,build oder --groups=all.

Optional: Wick.Runtime-Begleiter

Für die In-Process-Ausnahmeerfassung (asynchrone Ausnahmen, TaskScheduler.UnobservedTaskException) und Live-Szenenbaum-Abfragen fügen Sie den Wick.Runtime NuGet-Begleiter zu Ihrem Godot C#-Projekt hinzu:

dotnet add package Wick.Runtime

Binden Sie sowohl Install() als auch Tick() in den Einstiegspunkt Ihres Spiels ein — beides ist erforderlich:

using Wick.Runtime;

public partial class Main : Node
{
 public override void _Ready() => WickRuntime.Install();

 public override void _Process(double delta) => WickRuntime.Tick();
}

Wenn Ihre In-Process-Bridge-Tools (runtime_query_scene_tree usw.) für immer hängen bleiben, haben Sie Tick() vergessen. Install() allein deckt die Ausnahmeerfassung ab, aber Live-RPC-Handler benötigen Tick(), um den Dispatcher des Haupt-Threads zu leeren. Siehe docs/getting-started.md und das Paket-README für die vollständige Geschichte.

Architektur

Wick läuft als externer Prozess -- es läuft NICHT innerhalb von Godot. Kommunikation:

• stdio -- MCP-Protokoll zum KI-Client

• TCP 6505 -- Editor-Bridge (Godot-Plugin zum Wick-Server)

• TCP 7777 -- Laufzeit-Bridge (laufendes Spiel zum Wick-Server)

• TCP 7878 -- Wick.Runtime-Begleiter-Bridge (In-Process zum Wick-Server)

Diese Architektur ermöglicht es dem Wick-Server und den Provider-Projekten, auf .NET 10 abzuzielen, während der optionale In-Process-Begleiter Wick.Runtime auf net8.0 für die aktuelle stabile .NET-Laufzeitumgebung von Godot 4.6.1 bleibt.

Namensnennung

Wick ist eine Clean-Room-Neuimplementierung, inspiriert von GoPeak (MIT-Lizenz, (c) 2025 Solomon Elias / HaD0Yun). Siehe ATTRIBUTION.md für detaillierte Credits.

Mitwirken

Wir freuen uns über Beiträge! Bitte lesen Sie CONTRIBUTING.md, bevor Sie einen PR einreichen.

Demo

Klonen Sie das Repo und öffnen Sie docs/demo/player.html in einem Browser, um die Demo anzusehen, oder spielen Sie die Cast-Datei direkt ab:

asciinema play docs/demo/wick-demo.cast

Lizenz

MIT

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• detect_languageB
• gd_lsp_connectA
• gd_lsp_definitionA
• gd_lsp_hoverB
• gd_lsp_symbolsB
• gd_script_statusA
• godot_statusB
• project_infoA