Wick

Telemetría de excepciones en C# enriquecida con Roslyn para Godot Engine, expuesta a través de MCP.

👁 CI
👁 License: MIT

¿Qué es Wick?

Cuando un juego de Godot en C# falla, tu asistente de IA ve un seguimiento de pila (stack trace) sin procesar y pierde más de 8 turnos pidiéndote que abras archivos. Wick captura esa excepción, la enriquece con contexto de código fuente potenciado por Roslyn (el cuerpo del método real, la cadena de llamadas, registros recientes, estado de la escena) y entrega la imagen completa a la IA en una sola llamada. Un turno para el diagnóstico en lugar de diez.

¿Qué hace diferente a Wick?

Otros servidores MCP para Godot (como el excelente GoPeak) se centran en la manipulación de escenas y herramientas de GDScript. Wick se centra en la experiencia del desarrollador de C#/.NET:

• Telemetría de excepciones enriquecida con Roslyn -- excepciones de C# capturadas desde stderr enriquecidas con el cuerpo del método que realiza la llamada, líneas de código fuente circundantes, tipo envolvente y cadena de llamadas. Ningún otro servidor MCP de Godot hace esto.

• Captura de excepciones en proceso -- el complemento opcional Wick.Runtime NuGet captura TaskScheduler.UnobservedTaskException y excepciones asíncronas que stderr no puede ver.

• Diagnóstico de compilación con contexto de código fuente -- errores de dotnet build enriquecidos con contexto de código fuente de Roslyn a través de la misma canalización que las excepciones en tiempo de ejecución.

• Herramientas de análisis de C# -- buscar símbolos, buscar referencias, firmas de miembros a través del espacio de trabajo de Roslyn.

• Sistema de grupos de herramientas de 5 pilares -- activa solo lo que necesites: core, runtime, csharp, build, scene.

Related MCP server: GodotIQ

Primeros pasos

Requisitos previos

• .NET 10 SDK (10.0.201 o posterior)

• Godot 4.6.1+ con soporte para .NET/Mono

Instalación

Wick tiene dos partes: un complemento puente para el lado de Godot (/addons/wick/) y el servidor MCP de .NET.

Puente de Godot — instálalo a través de la biblioteca de activos de Godot en el editor (recomendado), o copia /addons/wick/ en tu proyecto manualmente.

Servidor MCP — clona y compila:

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

Configuración de MCP

Agrega Wick a la configuración de MCP de tu asistente de codificación de IA:

{
 "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"
 }
 }
 }
}

Grupos de herramientas

Activa los pilares de herramientas a través de la variable de entorno WICK_GROUPS o la bandera CLI --groups:

Ejemplo: WICK_GROUPS=core,runtime,csharp,build o --groups=all.

Opcional: Complemento Wick.Runtime

Para la captura de excepciones en proceso (excepciones asíncronas, TaskScheduler.UnobservedTaskException) y consultas al árbol de escenas en vivo, agrega el complemento NuGet Wick.Runtime a tu proyecto de C# en Godot:

dotnet add package Wick.Runtime

Conecta tanto Install() como Tick() en el punto de entrada de tu juego; ambos son necesarios:

using Wick.Runtime;

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

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

Si tus herramientas de puente en proceso (runtime_query_scene_tree, etc.) se bloquean indefinidamente, olvidaste Tick(). Install() por sí solo cubre la captura de excepciones, pero los controladores RPC en vivo necesitan Tick() para vaciar el despachador del hilo principal. Consulta docs/getting-started.md y el README del paquete para conocer la historia completa.

Arquitectura

Wick se ejecuta como un proceso externo; NO se ejecuta dentro de Godot. Comunicación:

• stdio -- protocolo MCP al cliente de IA

• TCP 6505 -- puente del editor (plugin de Godot al servidor Wick)

• TCP 7777 -- puente de tiempo de ejecución (juego en ejecución al servidor Wick)

• TCP 7878 -- puente del complemento Wick.Runtime (en proceso al servidor Wick)

Esta arquitectura permite que el servidor Wick y los proyectos proveedores apunten a .NET 10, mientras que el complemento opcional en proceso Wick.Runtime permanece en net8.0 para el tiempo de ejecución .NET estable actual de Godot 4.6.1.

Atribución

Wick es una reimplementación desde cero inspirada en GoPeak (Licencia MIT, (c) 2025 Solomon Elias / HaD0Yun). Consulta ATTRIBUTION.md para obtener créditos detallados.

Contribución

¡Agradecemos las contribuciones! Por favor, lee CONTRIBUTING.md antes de enviar un PR.

Demostración

Clona el repositorio y abre docs/demo/player.html en un navegador para ver la demostración, o reproduce el archivo cast directamente:

asciinema play docs/demo/wick-demo.cast

Licencia

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