Master Control Program (MCP) Backend

삼성 SmartThings 호텔 통합 데모

이는 삼성 스마트씽스와 호텔 예약 시스템을 통합하여 사용자 선호도에 따라 개인화된 온도 설정을 가능하게 하는 데모입니다.

개요

데모는 다음으로 구성됩니다.

1. 호텔 직원과 경영진을 위한 간소화된 프런트엔드 :
   • 사용자 및 온도 환경 설정 관리
   • 호텔 객실 관리
   • 예약 생성 및 관리
   • 객실 배정 및 투숙객 체크아웃
   • 호텔 통계 및 SmartThings 통합 상태 대시보드 보기
   • AI 챗봇 인터페이스를 사용하여 시스템과 상호 작용합니다.
2. MCP(마스터 제어 프로그램) 백엔드의 기능은 다음과 같습니다.
   • 프런트엔드에 대한 API 엔드포인트를 제공합니다.
   • 장치 제어를 위한 SmartThings API와 통합
   • 사용자 기본 설정, 객실 배정 및 예약을 관리합니다.

프로젝트 구조

지엑스피1

설정 및 설치

필수 조건

• Python 3.8 이상
• pip 패키지 관리자

설치 단계

1. 이 저장소를 복제하세요:
   git clone <repository-url> cd mcpSmartThings
2. 필요한 종속성을 설치하세요:
   pip install streamlit fastapi uvicorn pydantic pandas torch transformers

데모 실행

MCP 백엔드 서버 시작

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. 클로드 인터페이스 탭 :
   • AI 응답에 TinyLlama를 사용하려면 로컬 LLM 옵션을 활성화하세요.
   • 객실 예약이나 온도 환경 설정을 위해 도우미와 채팅하세요
   • 호텔 시스템에 대한 대화형 인터페이스를 경험해보세요

SmartThings 통합

이 데모에서는 SmartThings 통합을 시뮬레이션합니다. 실제 구현에서는 SmartThings API에 연결하여 다음을 제어합니다.

• 실내 온도(에어컨/난방)
• 실내 조명
• 도어 잠금 장치
• 기타 스마트 기기

고객이 체크인하면 고객의 프로필에 저장된 선호 온도가 SmartThings를 통해 지정된 객실에 자동으로 적용됩니다.

API 문서

MCP 서버가 실행되면 http://localhost:8000/docs 에서 API 문서에 액세스할 수 있습니다.

이는 사용 가능한 모든 API 엔드포인트를 탐색하고 테스트할 수 있는 대화형 인터페이스를 제공합니다.

문제 해결

• TinyLlama 모델 로딩에 문제가 발생하면 Claude Interface 탭에서 "로컬 LLM 사용" 토글을 비활성화하여 대신 기본 패턴 매칭 구현을 사용할 수 있습니다.
• MCP 서버가 연결되지 않으면 Streamlit 앱 사이드바에서 URL을 확인하세요(기본값은 http://localhost:8000 ).
• 데이터는 data 디렉터리의 JSON 파일로 저장됩니다. 사이드바에서 "데모 데이터 재설정"을 클릭하면 데이터를 재설정할 수 있습니다.

크레딧

이 데모는 삼성이 호텔 관리 시스템과 SmartThings 통합의 잠재력을 보여주기 위해 제작했습니다.