Samsung SmartThings 酒店集成演示

这是一个展示三星 SmartThings 与酒店预订系统集成的示例，允许根据用户偏好设置个性化的温度。

概述

该演示包括：

1. Streamlit 前端，供酒店员工和管理层使用：

   • 管理用户及其温度偏好
   • 管理酒店房间
   • 创建和管理预订
   • 分配房间并办理退房手续
   • 查看酒店统计数据和 SmartThings 集成状态的仪表板
   • 使用 AI 聊天机器人界面与系统交互

2. MCP（主控程序）后端，负责：

   • 为前端提供 API 端点
   • 与 SmartThings API 集成以控制设备
   • 管理用户偏好、房间分配和预订

项目结构

├── app.py # 主 Streamlit 应用程序 ├── mcp/ # MCP 后端 │ ├── server.py # FastAPI 服务器 │ ├── smartthings.py # SmartThings API 集成 ├── utils/ # 工具模块 │ ├── database.py # 本地数据库操作 ├── data/ # 数据存储（运行时创建） │ ├── users.json │ ├── rooms.json │ ├── bookings.json ├── README.md # 本文件

设置与安装

前提条件

• 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. Claude 接口标签页：

   • 启用本地 LLM 选项以使用 TinyLlama 获取 AI 响应
   • 与助手聊天以预订房间或设置温度偏好
   • 体验与酒店系统的对话式界面

SmartThings 集成

在本演示中，SmartThings 集成是模拟的。在实际实现中，它将连接到实际的 SmartThings API 来控制：

• 房间温度（空调/暖气）
• 房间照明
• 门锁
• 其他智能设备

当客人入住时，他们的首选温度（保存在其个人资料中）会通过 SmartThings 自动应用于他们分配的房间。

API 文档

一旦 MCP 服务器运行，您可以在以下地址访问 API 文档： http://localhost:8000/docs

这提供了探索和测试所有可用 API 端点的交互式界面。

故障排除

• 如果遇到 TinyLlama 模型加载问题，可以在 Claude Interface 标签页中禁用“Use Local LLM”切换按钮，以使用基本的模式匹配实现。
• 如果 MCP 服务器无法连接，请检查 Streamlit 应用侧边栏中的 URL（默认为 http://localhost:8000）。- 数据存储在 data 目录中的 JSON 文件里。您可以通过点击侧边栏中的“重置演示数据”来重置数据。

致谢

此演示由三星创建，用于展示 SmartThings 与酒店管理系统集成的潜力。