Smartthings MCP

🚀 smartthings - mcp

このプロジェクトは、いくつかのSmartThingsヘルパーツールを公開する小規模なModel Context Protocolサーバーを提供します。

"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 – デバイスにコマンドを送信します。