Integrations
Serves as the backend framework providing API endpoints for the hotel management system
Handles data processing and analysis for the hotel statistics dashboard
Provides data validation and settings management for the API
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:
- 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
- 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
Setup and Installation
Prerequisites
- Python 3.8 or higher
- pip package manager
Installation Steps
- Clone this repository:Copy
- Install required dependencies:Copy
Running the Demo
Start the MCP Backend Server
- Start the MCP backend server:The MCP server will start on http://localhost:8000Copy
- In a new terminal, start the Streamlit frontend:The Streamlit app will open in your browser at http://localhost:8501Copy
Using the Demo
- Load Sample Data:
- Go to the sidebar and click "Load Sample Data" to populate the system with sample users, rooms, and bookings.
- Users Tab:
- Create new users with their temperature preferences
- Update existing user temperature preferences
- Rooms Tab:
- Add new hotel rooms
- Set room temperatures manually
- Bookings Tab:
- Create new bookings for users
- Assign rooms to bookings (check-in)
- Process checkouts
- Dashboard Tab:
- View hotel statistics
- Monitor room temperatures
- Check SmartThings integration status
- 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.
This server cannot be installed
Provides API endpoints for a hotel management frontend and integrates with SmartThings API to control devices based on user preferences and room assignments.
Related MCP Servers
- -securityFlicense-qualityEnables users to control Google Home smart plugs using the Smart Home API with OAuth2 authentication, offering real-time device state management and control operations.Last updated -1TypeScript
- AsecurityFlicenseAqualityFacilitates access to LumbreTravel API for managing travel programs, activities, and related entities through MCP clients.Last updated -6891TypeScript
- -securityFlicense-qualityA versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.Last updated -2Python
- -securityAlicense-qualityA Model Context Protocol server that integrates with Home Assistant to provide smart home control capabilities through natural language, supporting devices like lights, climate systems, locks, alarms, and humidifiers.Last updated -PythonMIT License