Juego de MCPGame

Un juego de panel de control multijugador con backend Node.js que presenta un entorno de casa virtual con elementos interactivos.

Características

• Casa virtual 3D inmersiva en primera persona con entorno exterior

• Casa bellamente detallada con características interiores y exteriores.

• Puerta interactiva para entrar y salir de casa.

• Zona de jardín con árboles, plantas y elementos decorativos.

• Televisión interactiva con capacidades de generación de imágenes

• Terminal de computadora para acceder a los sistemas MCP

• Detección realista de movimientos y colisiones

• Comunicación con el servidor en tiempo real

Related MCP server: mind-mcp

Configuración

1. Instalar dependencias:

npm install

2. Ejecutar el servidor:

npm start

O para desarrollo con reinicio automático:

npm run dev

El servidor se iniciará en el puerto 3002.

Controles del juego

• Movimiento : Teclas WASD

• Mira a tu alrededor : Movimiento del ratón (haz clic en el juego para habilitarlo)

• Interactuar : Presione ENTER cuando esté cerca de objetos interactivos

• Interfaces de salida : tecla ESC

• Salir del bloqueo del ratón : tecla ESC

Elementos interactivos

Entorno exterior

• Explora el terreno con árboles y parterres.

• Sigue el camino hasta la entrada de la casa.

• Presione ENTER cuando esté cerca de la puerta para entrar/salir de la casa

Sistema de TV

• Acérquese al televisor y presione ENTER para acceder al control remoto

• Generar imágenes que se mostrarán en la pantalla del televisor.

• Escriba un mensaje para generar una imagen en la interfaz del terminal

Terminal MCP

• Busque el escritorio de la computadora y presione ENTER para acceder a la terminal

• Enviar comandos al sistema MCP

• Acceder a diversas herramientas virtuales (correo electrónico, búsqueda web, etc.)

Detalles técnicos

• Creado con Three.js para renderizado 3D

• Cámara en primera persona con controles de bloqueo del puntero

• Entorno exterior con árboles colocados de forma procedimental

• Servidor Express.js para comunicación backend

• Biblioteca de lienzo para la generación de imágenes

• API RESTful para la comunicación con el servidor

Sistema de imágenes de juegos MCP

Este documento explica cómo funciona el sistema de visualización de imágenes en el juego MCP.

Descripción general

El sistema muestra las imágenes existentes del directorio server/openai-server/public/image en el televisor de la casa virtual. En lugar de generar nuevas imágenes, lo que causaba errores internos del servidor 500, el sistema ahora busca imágenes existentes en el directorio especificado.

Cómo funciona

1. El televisor de la casa virtual muestra imágenes que existen en el directorio server/openai-server/public/image .

2. El sistema busca nuevas imágenes cada 10 segundos.

3. Cuando un usuario solicita una nueva imagen a través de la interfaz remota del televisor, el sistema selecciona una imagen aleatoria del directorio.

Agregar nuevas imágenes

Para agregar nuevas imágenes al televisor:

1. Coloque los archivos de imagen (jpg, jpeg, png, gif, webp) en el directorio server/openai-server/public/image .

2. El sistema los detectará y mostrará automáticamente.

3. Los archivos deben tener un tamaño razonable para su visualización en la web (recomendado: 800x450 píxeles).

Uso

1. Acérquese al televisor en la casa virtual.

2. Presione Enter para acceder a la interfaz de control remoto del televisor.

3. Escriba cualquier comando relacionado con la visualización de imágenes.

4. El sistema seleccionará y mostrará una imagen de las disponibles en el directorio.

Solución de problemas

• Si no se muestran imágenes, verifique si el directorio server/openai-server/public/image existe y contiene archivos de imagen.

• Asegúrese de que el servidor se esté ejecutando en el puerto correcto (predeterminado: 3002).

• Verifique la consola del navegador para ver si hay mensajes de error relacionados con la carga de imágenes.

Detalles técnicos

• El sistema ya no intenta generar imágenes directamente, evitando los errores 500 del servidor interno.

• Las imágenes se seleccionan aleatoriamente del directorio cuando se solicita.

• El sistema proporciona información adecuada cuando no hay imágenes disponibles.

Conexión al servidor backend de MCP

MCPGame se puede conectar a un servidor backend MCP externo para habilitar una funcionalidad de IA avanzada para las interacciones de la terminal y la TV.

Configuración

1. Abra el archivo main.js y localice la sección de configuración en la parte superior:

// --- Configuration ---
const MCP_BACKEND_URL = 'http://localhost:3001'; // MCP Terminal backend connection
const IMAGE_SERVER_URL = 'http://localhost:3002'; // Image server connection

2. Actualice MCP_BACKEND_URL para que apunte a su servidor backend MCP:

   • Para desarrollo local: http://localhost:PORT (reemplace PORT con su puerto de backend)

   • Para producción: utilice la URL completa de su servidor backend implementado

Puntos finales de API requeridos

Su servidor backend MCP debe implementar estos puntos finales:

1. GET /api/status - Devuelve el estado del sistema MCP

2. POST /api/query : acepta consultas del usuario y devuelve respuestas de IA

Formato de respuesta

El punto final de la consulta debe devolver JSON en este formato:

{
  "response": "Text to display in the terminal",
  "spokenResponse": "Optional text for voice synthesis" 
}

Probando la conexión

1. Inicie su servidor backend MCP

2. Inicie el servidor MCPGame ( node server.js )

3. Abre el juego en un navegador.

4. Interactúa con la terminal de computadora en la casa virtual

5. El juego se conectará a tu servidor backend de MCP cuando uses la terminal