为酒店管理前端提供API端点，并与SmartThings API集成，以根据用户偏好和房间分配控制设备。
432 查看 · 2026-07-07 更新
简介
为酒店管理前端提供API端点，并与SmartThings API集成，以根据用户偏好和房间分配控制设备。
简介
为酒店管理前端提供API端点，并与SmartThings API集成，以根据用户偏好和房间分配控制设备。
Samsung SmartThings 酒店集成演示
这是一个展示三星 SmartThings 与酒店预订系统集成的示例，允许根据用户偏好设置个性化的温度。
概述
该演示包括：
-
Streamlit 前端，供酒店员工和管理层使用：
- 管理用户及其温度偏好
- 管理酒店房间
- 创建和管理预订
- 分配房间并办理退房手续
- 查看酒店统计数据和 SmartThings 集成状态的仪表板
- 使用 AI 聊天机器人界面与系统交互
-
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 包管理器
安装步骤
-
克隆此仓库：
git clone
cd mcpSmartThings -
安装所需依赖项：
pip install streamlit fastapi uvicorn pydantic pandas torch transformers
运行演示
启动 MCP 后端服务器
-
启动 MCP 后端服务器：
cd mcpSmartThings python -m mcp.server
MCP 服务器将在 http://localhost:8000 上启动
-
在新的终端中，启动 Streamlit 前端：
cd mcpSmartThings streamlit run app.py
Streamlit 应用将在您的浏览器中打开，地址为 http://localhost:8501
使用演示
-
加载示例数据：
- 转到侧边栏并点击“加载示例数据”以填充系统中的示例用户、房间和预订。
-
用户标签页：
- 创建具有其温度偏好的新用户
- 更新现有用户的温度偏好
-
房间标签页：
- 添加新的酒店房间
- 手动设置房间温度
-
预订标签页：
- 为用户创建新的预订
- 将房间分配给预订（入住）
- 处理退房
-
仪表板标签页：
- 查看酒店统计数据
- 监控房间温度
- 检查 SmartThings 集成状态
-
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 与酒店管理系统集成的潜力。
来源
- 来源：github
- 链接：https://github.com/sayonsom/mcpSmartThings