Samsung SmartThings Hotel Integration Demo

This is a demonstration of the integration between Samsung SmartThings and a hotel booking system, allowing personalized temperature settings based on user preferences.

Overview

The demo consists of:

1. A Streamlit Frontend for hotel staff and management to:

   • Manage users and their temperature preferences
   • Manage hotel rooms
   • Create and manage bookings
   • Assign rooms and check out guests
   • View a dashboard of hotel stats and SmartThings integration status
   • Use an AI chatbot interface to interact with the system

2. An MCP (Master Control Program) Backend which:

   • Provides API endpoints for the frontend
   • Integrates with SmartThings API for device control
   • Manages user preferences, room assignments, and bookings

Project Structure

├── app.py                  # Main Streamlit application
├── mcp/                    # MCP backend
│   ├── server.py           # FastAPI server
│   ├── smartthings.py      # SmartThings API integration
├── utils/                  # Utility modules
│   ├── database.py         # Local database operations
├── data/                   # Data storage (created at runtime)
│   ├── users.json
│   ├── rooms.json
│   ├── bookings.json
├── README.md               # This file

Setup and Installation

Prerequisites

• Python 3.8 or higher
• pip package manager

Installation Steps

1. Clone this repository:

   git clone <repository-url>
   cd mcpSmartThings
   

2. Install required dependencies:

   pip install streamlit fastapi uvicorn pydantic pandas torch transformers
   

Running the Demo

Start the MCP Backend Server

1. Start the MCP backend server:

   cd mcpSmartThings
   python -m mcp.server
   

   The MCP server will start on http://localhost:8000

2. In a new terminal, start the Streamlit frontend:

   cd mcpSmartThings
   streamlit run app.py
   

   The Streamlit app will open in your browser at http://localhost:8501

Using the Demo

1. Load Sample Data:

   • Go to the sidebar and click "Load Sample Data" to populate the system with sample users, rooms, and bookings.

2. Users Tab:

   • Create new users with their temperature preferences
   • Update existing user temperature preferences

3. Rooms Tab:

   • Add new hotel rooms
   • Set room temperatures manually

4. Bookings Tab:

   • Create new bookings for users
   • Assign rooms to bookings (check-in)
   • Process checkouts

5. Dashboard Tab:

   • View hotel statistics
   • Monitor room temperatures
   • Check SmartThings integration status

6. Claude Interface Tab:

   • Enable the local LLM option to use TinyLlama for AI responses
   • Chat with the assistant to book rooms or set temperature preferences
   • Experience a conversational interface to the hotel system

SmartThings Integration

The SmartThings integration is simulated in this demo. In a real-world implementation, it would connect to the actual SmartThings API to control:

• Room temperature (AC/heating)
• Room lighting
• Door locks
• Other smart devices

When a guest checks in, their preferred temperature (saved in their profile) is automatically applied to their assigned room through SmartThings.

API Documentation

Once the MCP server is running, you can access the API documentation at: http://localhost:8000/docs

This provides an interactive interface to explore and test all available API endpoints.

Troubleshooting

• If you encounter issues with the TinyLlama model loading, you can disable the "Use Local LLM" toggle in the Claude Interface tab to use the basic pattern matching implementation instead.
• If the MCP server isn't connecting, check the URL in the Streamlit app sidebar (default is http://localhost:8000).
• Data is stored in JSON files in the data directory. You can reset the data by clicking "Reset Demo Data" in the sidebar.

Credits

This demonstration was created by Samsung for illustrating the potential of SmartThings integration with hotel management systems.