# SmartThings酒店智能设备管理
## 基本信息
- Slug: `sayonsom-mcpsmartthings`
- Source: modelscope
- Publisher: @sayonsom/mcpSmartThings
- Categories: app-automation / home-automation-and-iot
- Hosted: No
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/@sayonsom/mcpSmartThings
## 简介
为酒店管理前端提供API端点，并与SmartThings API集成，以根据用户偏好和房间分配控制设备。
## MCP Server 详情

# 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 与酒店管理系统集成的潜力。