Master Control Program (MCP) Backend

Demostración de integración de Samsung SmartThings en hoteles

Esta es una demostración de la integración entre Samsung SmartThings y un sistema de reserva de hotel, que permite configuraciones de temperatura personalizadas según las preferencias del usuario.

Descripción general

La demostración consta de:

1. Una interfaz Streamlit para que el personal y la gerencia del hotel puedan:
   • Administrar usuarios y sus preferencias de temperatura
   • Administrar habitaciones de hotel
   • Crear y gestionar reservas
   • Asignar habitaciones y registrar la salida de los huéspedes
   • Vea un panel de estadísticas del hotel y el estado de integración de SmartThings
   • Utilice una interfaz de chatbot de IA para interactuar con el sistema
2. Un backend MCP (programa de control maestro) que:
   • Proporciona puntos finales de API para el frontend
   • Se integra con la API de SmartThings para el control de dispositivos.
   • Gestiona las preferencias de los usuarios, las asignaciones de salas y las reservas.

Estructura del proyecto

Configuración e instalación

Prerrequisitos

• Python 3.8 o superior
• gestor de paquetes pip

Pasos de instalación

1. Clonar este repositorio:
   git clone <repository-url> cd mcpSmartThings
2. Instalar las dependencias necesarias:
   pip install streamlit fastapi uvicorn pydantic pandas torch transformers

Ejecución de la demostración

Iniciar el servidor backend de MCP

1. Inicie el servidor backend de MCP:
   cd mcpSmartThings python -m mcp.server
   El servidor MCP se iniciará en http://localhost:8000
2. En una nueva terminal, inicie el frontend de Streamlit:
   cd mcpSmartThings streamlit run app.py
   La aplicación Streamlit se abrirá en su navegador en http://localhost:8501

Usando la demostración

1. Cargar datos de muestra :
   • Vaya a la barra lateral y haga clic en "Cargar datos de muestra" para completar el sistema con usuarios, habitaciones y reservas de muestra.
2. Pestaña Usuarios :
   • Crea nuevos usuarios con sus preferencias de temperatura
   • Actualizar las preferencias de temperatura del usuario existente
3. Pestaña Habitaciones :
   • Añadir nuevas habitaciones de hotel
   • Establecer manualmente la temperatura de las habitaciones
4. Pestaña de reservas :
   • Crear nuevas reservas para usuarios
   • Asignar habitaciones a reservas (check-in)
   • Proceso de pago
5. Pestaña del panel :
   • Ver estadísticas del hotel
   • Monitorear la temperatura ambiente
   • Comprobar el estado de integración de SmartThings
6. Pestaña de interfaz de Claude :
   • Habilite la opción LLM local para usar TinyLlama para respuestas de IA
   • Chatea con el asistente para reservar habitaciones o establecer preferencias de temperatura.
   • Experimente una interfaz conversacional con el sistema del hotel.

Integración de SmartThings

En esta demostración se simula la integración de SmartThings. En una implementación real, se conectaría a la API de SmartThings para controlar:

• Temperatura ambiente (aire acondicionado/calefacción)
• Iluminación de la habitación
• Cerraduras de puertas
• Otros dispositivos inteligentes

Cuando un huésped realiza el check-in, su temperatura preferida (guardada en su perfil) se aplica automáticamente a su habitación asignada a través de SmartThings.

Documentación de la API

Una vez que el servidor MCP esté en ejecución, puede acceder a la documentación de la API en: http://localhost:8000/docs

Esto proporciona una interfaz interactiva para explorar y probar todos los puntos finales de API disponibles.

Solución de problemas

• Si tiene problemas con la carga del modelo TinyLlama, puede desactivar el interruptor "Usar LLM local" en la pestaña Interfaz de Claude para utilizar en su lugar la implementación básica de coincidencia de patrones.
• Si el servidor MCP no se conecta, verifique la URL en la barra lateral de la aplicación Streamlit (el valor predeterminado es http://localhost:8000 ).
• Los datos se almacenan en archivos JSON en el directorio data . Puede restablecerlos haciendo clic en "Restablecer datos de demostración" en la barra lateral.

Créditos

Esta demostración fue creada por Samsung para ilustrar el potencial de la integración de SmartThings con los sistemas de gestión hotelera.