smartthings-mcp

🚀 smartthings - mcp

本项目提供了一个小型的 模型上下文协议（Model Context Protocol） 服务器，该服务器集成了一些 SmartThings 辅助工具。

🚀 快速开始

配置示例

"mcpServers": {
  "SmartThings": {
    "type": "stdio",
    "command": "uv",
    "args": [
        "run",
        "src/mcp_smartthings/server.py"
    ],
    "env": {
        "TOKEN": "Your Personal Token"
    }
  }
}

🐳 Docker 使用说明

为方便使用，项目中包含了一个 Dockerfile。可以使用以下命令构建并运行镜像：

docker build -t smartthings-mcp .
docker run -e TOKEN=<api token> smartthings-mcp

容器会使用 uv 安装生产环境依赖，并通过 uv run src/mcp_smartthings/server.py 启动服务器。

✨ 可用工具

服务器提供了以下 MCP 工具：

• get_rooms – 返回房间 UUID 与名称的映射。
• get_devices – 列出设备，支持可选的过滤功能。
• get_device_status – 通过 UUID 获取设备的状态。
• execute_commands – 向设备发送命令。