loxone-mcp

AIアシスタントをLoxone Miniserverスマートホームシステムに接続するMCP（Model Context Protocol）サーバーです。

Claude（またはMCP互換のAI）が部屋の一覧表示、ライブセンサー/アクチュエーター状態のクエリ、デバイスの検索、コマンドの送信を行えるようにします。

機能

• list_rooms — コントロールを含むすべての部屋

• list_controls — すべてのコントロール（名前、タイプ、UUID、部屋）

• find_control — 名前/部屋/タイプによるキーワード検索

• get_status — ライブセンサーおよびアクチュエーターの値（オプションで部屋によるフィルタリングが可能）

• control_device — コマンドの送信（オン/オフ、調光%、ブラインド、HVAC、オーディオ）

Related MCP server: Loxone MCP Server

要件

• Cloud Connectが有効なLoxone Miniserver

• Node.js 20以上（またはDocker）

インストール

npm

npm install -g @syntropic/loxone-mcp

次に、環境変数を設定して実行します：

LOXONE_SERIAL=XXXXXXXXXXXX \
LOXONE_USER=admin \
LOXONE_PASS=yourpass \
MCP_API_KEY=$(openssl rand -hex 32) \
loxone-mcp

ソースから

git clone https://github.com/syntropicsignal-ai/loxone-mcp.git
cd loxone-mcp
cp .env.example .env
# edit .env with your Miniserver serial, credentials, and a random API key
npm install
npm run build
npm start

サーバーは http://localhost:3000 でリッスンします。MCPエンドポイントは POST /mcp です。

Docker

docker build -t loxone-mcp .
docker run -p 3000:3000 --env-file .env loxone-mcp

設定

Claudeへの接続

ClaudeのMCP設定に追加してください：

{
  "mcpServers": {
    "loxone": {
      "url": "https://your-server/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

デバイスタイプ別のサポートされているコマンド

アーキテクチャ

• ステートレスHTTPサーバー — 各 POST /mcp は新しいトランスポートを作成します（セッション状態は保持されません）

• Loxone Cloud Connect: リクエストごとに dns.loxonecloud.com を介して現在のトンネルURLを解決します

• 構造キャッシュ: Loxoneアプリの構造 (LoxAPP3.json) は60秒間キャッシュされます

ライセンス

MIT