Juegos Grokade WebGL-MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para analizar y optimizar juegos WebGL. Este servidor proporciona herramientas para analizar aplicaciones WebGL, optimizar el rendimiento y obtener información sobre juegos y aplicaciones WebGL.

Tabla de contenido

• Descripción general
• Características
• Prerrequisitos
• Inicio rápido
• Instalación
• Uso con herramientas compatibles con MCP
• Herramientas disponibles
• Mejor integración de plantillas WebGL minimalistas
• Desarrollo
• Solución de problemas
• Guiones
• Contribuyendo
• Licencia
• Contacto

Descripción general

El Protocolo de Contexto de Modelo (MCP) es un protocolo abierto que permite una integración fluida entre aplicaciones LLM y fuentes de datos y herramientas externas. Este servidor WebGL-MCP implementa el protocolo para proporcionar herramientas especializadas de análisis y optimización WebGL a desarrolladores de juegos y creadores de aplicaciones web.

Al utilizar este servidor con herramientas compatibles con MCP, como IDE impulsados por IA, puede analizar fácilmente sus aplicaciones WebGL, obtener recomendaciones de optimización y mejorar el rendimiento de su juego en diferentes plataformas.

Características

• Análisis de aplicaciones WebGL
• Sugerencias de optimización del rendimiento
• Análisis del uso de la memoria
• Detección de motores (Unity, Godot, etc.)
• Recomendaciones de optimización de sombreadores
• Detección y análisis de plantillas
• Sugerencias de optimización específicas de la plantilla
• Recomendaciones de optimización móvil
• Análisis de la estructura y el tamaño de los archivos
• Evaluación de la capacidad de WebGL

Prerrequisitos

• Node.js 16.x o superior
• npm 7.x o superior
• Una aplicación o juego WebGL para analizar

Inicio rápido

Ahora puede conectarse al servidor utilizando cualquier cliente compatible con MCP y utilizar las herramientas disponibles para analizar sus aplicaciones WebGL.

Instalación

Uso con herramientas compatibles con MCP

Este servidor MCP está diseñado para funcionar con herramientas compatibles con MCP y proporcionar contexto a las aplicaciones WebGL. Para usarlo:

1. Inicie el servidor MCP:

O utilice el script proporcionado:

2. En su herramienta compatible con MCP (como un IDE o agente impulsado por IA), conéctese al servidor MCP.
3. Utilice las herramientas disponibles para analizar y optimizar sus aplicaciones WebGL.

Herramientas disponibles

analizar-webgl

Analiza una compilación WebGL o un archivo HTML. Proporciona información sobre la plantilla utilizada, las características detectadas, la estructura del archivo y las recomendaciones de optimización.

Parámetros:

• path (obligatorio): Ruta a la carpeta de compilación de WebGL o al archivo index.html

Ejemplo:

La salida incluye:

• Análisis de plantillas (tipo, características, etc.)
• Crear estadísticas (cantidad de archivos, tamaños)
• Detección de archivos grandes
• Recomendaciones de optimización

optimizar-webgl

Sugiere optimizaciones para aplicaciones WebGL según objetivos específicos.

Parámetros:

• path (obligatorio): Ruta a la carpeta de compilación de WebGL o al archivo index.html
• targetFPS (opcional): fotogramas objetivo por segundo
• memoryLimit (opcional): Límite de memoria en MB
• optimizationGoals (opcional): Matriz de objetivos de optimización ('rendimiento', 'memoria', 'calidad', 'móvil')

Ejemplo:

La salida incluye:

• Recomendaciones de optimización específicas para cada plantilla
• Sugerencias de optimización de código y activos
• Optimizaciones específicas para dispositivos móviles (cuando se especifiquen)
• Mejoras en el uso de memoria (cuando se especifique)

analizar el rendimiento

Analiza métricas de rendimiento y proporciona recomendaciones específicas según el rendimiento.

Parámetros:

• path (obligatorio): Ruta a la carpeta de compilación de WebGL o al archivo index.html
• duration (opcional): Duración de la prueba de rendimiento en segundos

Ejemplo:

La salida incluye:

• Evaluación de las capacidades de WebGL
• Identificación de cuellos de botella en el rendimiento
• Análisis de la velocidad de fotogramas
• Sugerencias para optimizar la carga de activos

Mejor integración de plantillas WebGL minimalistas

Este servidor MCP ofrece soporte específico para analizar y recomendar optimizaciones al usar la plantilla Better Minimal WebGL , una plantilla altamente optimizada para compilaciones WebGL de Unity. Este recurso externo se utiliza como referencia para las mejores prácticas y optimizaciones.

Consideraciones sobre la versión de la plantilla

La plantilla Better Minimal WebGL viene en diferentes versiones para diferentes versiones de Unity:

• Versión 2.2 : para Unity 2020.2 y superior: incluye la funcionalidad de barra de carga
• Versión 2.1 : para Unity 2020.1: características similares a la versión 2.2 sin algunas funciones más nuevas
• Versión 1.1 : para Unity 2019.x y anteriores: funcionalidad principal sin características más nuevas

El servidor MCP analizará y detectará características basadas en cualquier versión, pero puede proporcionar recomendaciones diferentes dependiendo de la versión de plantilla que se utilice.

Características de la plantilla analizadas

• Escalado del lienzo para diferentes tamaños de pantalla
• Visualización del progreso de carga
• Detección y optimización de dispositivos móviles
• Optimización de la representación de pixel art

Mejores prácticas para usar una plantilla WebGL minimalista

Basado en la documentación de la plantilla oficial:

1. Escalado de lienzo : habilite siempre el escalado para juegos interactivos
   • Mantiene la relación de aspecto mientras llena la ventana.
   • Centra el lienzo en la ventana.
   • Funciona bien en todos los tamaños de pantalla.
2. Optimización móvil :
   • La plantilla detecta automáticamente los dispositivos móviles y establece la configuración de ventana gráfica adecuada.
   • No se necesita ningún código adicional para la compatibilidad básica con dispositivos móviles
3. Juegos de Pixel Art :
   • Utilice la opción "Optimizar para pixel art" para obtener una representación nítida de los píxeles.
   • Esto permite propiedades de representación de imágenes CSS adecuadas en todos los navegadores.
4. Visualización de carga :
   • La plantilla incluye una barra de carga sencilla y efectiva.
   • No hay elementos de interfaz de usuario complejos que puedan ralentizar la carga inicial
5. Personalización del fondo :
   • Establece un color de fondo personalizado que complemente la estética de tu juego.
   • El contenedor de juego transparente garantiza que el fondo sea visible.
6. Ideal para empotrar :
   • Funciona perfectamente en sitios como itch.io que proporcionan botones externos de pantalla completa.
   • Ligero con mínima sobrecarga
7. Comportamiento de pantalla completa :
   • Cuando se integra en sitios como itch.io, utilice su botón de pantalla completa en lugar de implementar el suyo propio.
   • La plantilla se escalará automáticamente para llenar el espacio disponible cuando esté en modo de pantalla completa.
   • Para implementaciones independientes, considere agregar un botón simple de pantalla completa
8. Compatibilidad :
   • Funciona en todos los navegadores principales.
   • Se degrada con elegancia cuando las funciones no son compatibles

Implementación de plantilla

Para implementar la plantilla Better Minimal WebGL en su proyecto de Unity:

1. Descargue la versión adecuada para su versión de Unity desde itch.io (recurso externo)
2. Extraiga la carpeta WebGLTemplates a la carpeta Assets de su proyecto Unity
3. En Unity, vaya a Archivo > Configuración de compilación > WebGL > Configuración del reproductor
4. En Resolución y presentación, seleccione la plantilla "BetterMinimal".
5. Configurar las opciones:
   • Introduzca un color en el campo "Fondo" (por ejemplo, "#000" para negro)
   • Ingrese "falso" en el campo "Escalar para ajustar" para deshabilitar el escalado (el valor predeterminado es verdadero)
   • Ingrese "verdadero" en el campo "Optimizar para pixel art" para juegos de pixel art (el valor predeterminado es falso).

Desarrollo

Para contribuir a este proyecto:

1. Bifurcar el repositorio
2. Crear una rama de características
3. Realiza tus cambios
4. Enviar una solicitud de extracción

Aceptamos contribuciones que mejoren las capacidades de análisis, agreguen nuevas técnicas de optimización o mejoren la integración de MCP.

Solución de problemas

Problemas comunes y soluciones:

• Errores de conexión : asegúrese de que su cliente MCP esté configurado correctamente para conectarse al servidor
• Ruta no encontrada : Verifique que la ruta a su compilación WebGL sea correcta y accesible
• Errores de análisis : asegúrese de que su compilación WebGL tenga todos los archivos necesarios, incluido index.html

Para una solución de problemas más detallada, consulte los registros en los archivos error.log y combined.log .

Guiones

• npm run build : Construye el proyecto TypeScript
• npm run dev : ejecuta el servidor de desarrollo con recarga en caliente
• npm run start : Inicia el servidor compilado
• npm run webgl-mcp : Inicia el servidor WebGL MCP
• npm run simple-mcp : Inicia un servidor MCP simple para realizar pruebas
• npm run test : Ejecutar pruebas
• npm run lint : Ejecutar linting
• npm run format : Código de formato

Contribuyendo

¡Agradecemos las contribuciones de la comunidad! Si quieres corregir errores, mejorar la documentación o añadir nuevas funciones, no dudes en enviar una solicitud de incorporación de cambios.

1. Bifurcar el repositorio
2. Crear una rama de características ( git checkout -b feature/amazing-feature )
3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )
4. Empujar a la rama ( git push origin feature/amazing-feature )
5. Abrir una solicitud de extracción

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Contacto

Sitio web de Grokade Games

Enlace del proyecto: https://github.com/grokadegames/webgl-mcp