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"
    }
  }
}

📦 安装指南

为了方便使用，项目中包含了一个 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：向设备发送命令。