Master Control Program (MCP) Backend

Демонстрация интеграции Samsung SmartThings в гостиничном бизнесе

Это демонстрация интеграции Samsung SmartThings и системы бронирования отелей, позволяющая персонализировать настройки температуры на основе предпочтений пользователя.

Обзор

Демо состоит из:

1. Удобный интерфейс для персонала и руководства отеля, позволяющий:
   • Управление пользователями и их температурными предпочтениями
   • Управление гостиничными номерами
   • Создавайте и управляйте бронированиями
   • Распределите комнаты и выселите гостей
   • Просмотр панели статистики отеля и статуса интеграции SmartThings
   • Используйте интерфейс чат-бота на основе искусственного интеллекта для взаимодействия с системой
2. Бэкэнд MCP (главная программа управления), которая:
   • Предоставляет конечные точки API для интерфейса
   • Интегрируется с API SmartThings для управления устройством
   • Управляет предпочтениями пользователей, назначением номеров и бронированием

Структура проекта

Настройка и установка

Предпосылки

• Python 3.8 или выше
• менеджер пакетов pip

Этапы установки

1. Клонируйте этот репозиторий:
   git clone <repository-url> cd mcpSmartThings
2. Установите необходимые зависимости:
   pip install streamlit fastapi uvicorn pydantic pandas torch transformers

Запуск демонстрации

Запустите сервер MCP Backend

1. Запустите внутренний сервер MCP:
   cd mcpSmartThings python -m mcp.server
   Сервер MCP запустится по адресу http://localhost:8000
2. В новом терминале запустите интерфейс Streamlit:
   cd mcpSmartThings streamlit run app.py
   Приложение Streamlit откроется в вашем браузере по адресу http://localhost:8501.

Использование демо-версии

1. Загрузить образец данных :
   • Перейдите на боковую панель и нажмите «Загрузить образец данных», чтобы заполнить систему образцами пользователей, номеров и бронирований.
2. Вкладка «Пользователи» :
   • Создавайте новых пользователей с их температурными предпочтениями
   • Обновите существующие настройки температуры пользователя.
3. Вкладка «Комнаты» :
   • Добавить новые гостиничные номера
   • Установите температуру в помещении вручную
4. Вкладка «Бронирования» :
   • Создавайте новые бронирования для пользователей
   • Назначение номеров для бронирования (регистрация)
   • Процесс проверки
5. Вкладка «Панель инструментов» :
   • Посмотреть статистику отеля
   • Контролируйте температуру в помещении
   • Проверьте статус интеграции SmartThings
6. Вкладка «Интерфейс Клода» :
   • Включите локальную опцию LLM, чтобы использовать TinyLlama для ответов ИИ
   • Пообщайтесь с помощником, чтобы забронировать номера или задать желаемую температуру
   • Испытайте диалоговый интерфейс с гостиничной системой

Интеграция SmartThings

Интеграция SmartThings моделируется в этой демонстрации. В реальной реализации она будет подключаться к реальному API SmartThings для управления:

• Комнатная температура (кондиционер/отопление)
• Освещение помещения
• Дверные замки
• Другие смарт-устройства

Когда гость регистрируется, его предпочтительная температура (сохраненная в профиле) автоматически применяется к назначенному ему номеру через SmartThings.

API-документация

После запуска сервера MCP вы сможете получить доступ к документации API по адресу: http://localhost:8000/docs

Это обеспечивает интерактивный интерфейс для изучения и тестирования всех доступных конечных точек API.

Поиск неисправностей

• Если у вас возникли проблемы с загрузкой модели TinyLlama, вы можете отключить переключатель «Использовать локальный LLM» на вкладке Интерфейс Клода, чтобы вместо этого использовать базовую реализацию сопоставления с образцом.
• Если сервер MCP не подключается, проверьте URL-адрес на боковой панели приложения Streamlit (по умолчанию http://localhost:8000 ).
• Данные хранятся в файлах JSON в каталоге data . Вы можете сбросить данные, нажав «Сбросить демо-данные» на боковой панели.

Кредиты

Данная демонстрация была создана компанией Samsung для иллюстрации потенциала интеграции SmartThings с системами управления гостиницей.