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：向設備發送命令。