Master Control Program (MCP) Backend

by sayonsom

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:

  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.

-
security - not tested
F
license - not found
-
quality - not tested

Provides API endpoints for a hotel management frontend and integrates with SmartThings API to control devices based on user preferences and room assignments.

  1. Overview
    1. Project Structure
      1. Setup and Installation
        1. Prerequisites
        2. Installation Steps
      2. Running the Demo
        1. Start the MCP Backend Server
      3. Using the Demo
        1. SmartThings Integration
          1. API Documentation
            1. Troubleshooting
              1. Credits

                Related MCP Servers

                • -
                  security
                  F
                  license
                  -
                  quality
                  Enables 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 -
                  1
                  TypeScript
                • A
                  security
                  F
                  license
                  A
                  quality
                  Facilitates access to LumbreTravel API for managing travel programs, activities, and related entities through MCP clients.
                  Last updated -
                  68
                  9
                  1
                  TypeScript
                • -
                  security
                  F
                  license
                  -
                  quality
                  A 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 -
                  2
                  Python
                  • Apple
                  • Linux
                • -
                  security
                  A
                  license
                  -
                  quality
                  A 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 -
                  Python
                  MIT License
                  • Apple

                View all related MCP servers

                ID: ad45podvpm