Domotz

Domotz MCP サーバー

Domotz のネットワーク監視と管理のための Model Context Protocol（MCP）サーバーです。AI アシスタントを使って、ネットワークデバイスの監視、アラートの表示、デバイスのステータス確認、ネットワークインフラストラクチャの管理を行えます。

これは、Claude（または MCP 互換の AI）を Domotz 環境に接続する Model Context Protocol（MCP） サーバーです。

MSP Claude Plugins エコシステムの一部です — MSP スタック向けの AI 統合機能を拡充するスイートです。MSP が MSP のために構築しました。

インストール

npm install @wyre-ai/domotz-mcp

設定

.env.example をコピーし、以下の変数を設定してください。

変数	必須	説明
DOMOTZ_API_KEY	stdio および AUTH_MODE=env の場合	Domotz Public API キー
DOMOTZ_REGION	いいえ	API リージョンのセルラベル（デフォルト：us-east-1）
MCP_TRANSPORT	いいえ	stdio（デフォルト）または http
AUTH_MODE	いいえ	gateway（Docker イメージおよび Compose のデフォルト）または env。Gateway モードでは、各 /mcp リクエストに X-Domotz-API-Key が必要で、DOMOTZ_API_KEY へのフォールバックは行いません。env では、S2S 認証の成功後にのみこの変数を使用します。
CONDUIT_S2S_SECRET	HTTP では必須	サービス間シークレット。この値が空、または既知のプレースホルダー（changeme、secret、your-s2s-secret、replace-with-a-real-secret、および src/http.ts で拒否されるその他の値）の場合、HTTP サーバーはエラーを記録してゼロ以外の終了コードで終了します。この値がないと Compose は起動しません。実際の値をコミットしないでください。この値がログに記録されることはありません。
MCP_ALLOW_INSECURE_DEV	いいえ	CONDUIT_S2S_SECRET がなくても HTTP を起動するには、ローカル開発時に限り、正確に 1 を設定してください。プロセスは警告を記録し、X-Gateway-S2S を必須にせず、127.0.0.1 のみをバインドします。ループバック以外の MCP_HTTP_HOST は無視され、その上書きがログに記録されます。既知のプレースホルダーシークレットは引き続き拒否されます。
MCP_HTTP_HOST	いいえ	MCP_TRANSPORT=http の場合のバインドアドレスです。デフォルトは 127.0.0.1 です。CONDUIT_S2S_SECRET が設定されている場合に適用されます。コンテナーイメージでは 0.0.0.0 が設定されます。
MCP_HTTP_PORT	いいえ	HTTP ポートです。デフォルトは 8080 です。

/health は認証不要のままで、認証情報を読み取りません。stdio トランスポートでは CONDUIT_S2S_SECRET を使用しません。

HTTP 認証

MCP_TRANSPORT=http かつ CONDUIT_S2S_SECRET が設定されている場合、すべての /mcp リクエストに X-Gateway-S2S を含める必要があります。検証処理は src/s2s-verify.ts の verifyS2sHeader です。ヘッダー値は t=<unix seconds>,v1=<hex> で、hex は CONDUIT_S2S_SECRET をキーとして、文字列 t=<unix seconds> そのものに対して計算した HMAC-SHA256 です（小文字の 16 進数 64 文字）。タイムスタンプはサーバー時刻から 300 秒以内でなければなりません。ヘッダーがない場合、または無効な場合は、ベンダーの認証情報を読み取る前に 401 を返します。

TS=$(date +%s)
SIG=$(printf 't=%s' "$TS" | openssl dgst -sha256 -hmac "$CONDUIT_S2S_SECRET" -hex | awk '{print $NF}')
curl -sS http://127.0.0.1:8080/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H "X-Gateway-S2S: t=${TS},v1=${SIG}" \
  -H "X-Domotz-API-Key: $DOMOTZ_API_KEY" \
  -H 'X-Domotz-Region: us-east-1' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

AUTH_MODE=gateway では、/mcp に X-Domotz-API-Key も必要です（X-Domotz-Region は省略可能で、デフォルトは us-east-1 です）。このヘッダーのみがリクエストの認証情報ソースとなります。AUTH_MODE=env でも有効な X-Gateway-S2S ヘッダーは引き続き必要で、ベンダーの認証情報は DOMOTZ_API_KEY から取得します。

使用方法

Claude Desktop での実行

Claude Desktop の claude_desktop_config.json に追加してください。

{
  "mcpServers": {
    "domotz-mcp": {
      "command": "npx",
      "args": ["@wyre-ai/domotz-mcp"],
      "env": {
        "DOMOTZ_API_KEY": "your-domotz-api-key"
      }
    }
  }
}

Claude Code での実行（CLI）

claude mcp add domotz-mcp \
  -e DOMOTZ_API_KEY=your-value \
  -- npx -y @wyre-ai/domotz-mcp

Docker

イメージはコンテナー内で0.0.0.0（MCP_HTTP_HOST）をリッスンし、デフォルトでAUTH_MODE=gatewayを使用します。ポートをループバックに公開し、S2S シークレットを渡してください。ゲートウェイモードでは、Domotz API キーは各リクエストのX-Domotz-API-Keyとして渡され、環境変数からは読み込まれません。Compose ではDOMOTZ_API_KEYを設定しません。

docker build -t domotz-mcp .
docker run \
  -e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \
  -p 127.0.0.1:8080:8080 \
  domotz-mcp

CONDUIT_S2S_SECRETが未設定の場合、Compose は起動を拒否します。また、AUTH_MODE=gatewayを設定し、127.0.0.1:8080:8080を公開します。openssl rand -hex 32でシークレットを生成してください。your-s2s-secretのようなプレースホルダーは使用しないでください。

CONDUIT_S2S_SECRET="$(openssl rand -hex 32)" docker compose up

シングルテナントの HTTP（AUTH_MODE=env）でも S2S シークレットが必要で、そのうえでDOMOTZ_API_KEYを使用します。

docker run \
  -e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \
  -e AUTH_MODE=env \
  -e DOMOTZ_API_KEY=your-value \
  -e DOMOTZ_REGION=us-east-1 \
  -p 127.0.0.1:8080:8080 \
  domotz-mcp

シークレットを使用しないローカル HTTP は、開発専用です。127.0.0.1のみにバインドし、警告をログに記録します。0.0.0.0を含む、ループバック以外のMCP_HTTP_HOSTは無視されます。

MCP_TRANSPORT=http MCP_ALLOW_INSECURE_DEV=1 npm run start:http

利用可能なドメイン

エージェント

Domotz の監視エージェントを管理します

アラート

ネットワークアラートを表示および管理します

デバイス

デバイスの検出とステータス監視

メトリクス

ネットワークパフォーマンスのメトリクス

ネットワーク

ネットワークトポロジーと構成

電源

管理対象デバイスの電源管理

開発

# Clone the repository
git clone https://github.com/WYRE-AI/domotz-mcp.git
cd domotz-mcp

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# HTTP transport refuses to start until CONDUIT_S2S_SECRET is a real secret
CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" npm run start:http

# Local HTTP only, without a service-to-service secret (always binds 127.0.0.1)
MCP_ALLOW_INSECURE_DEV=1 npm run start:http

コントリビューション

コントリビューションを歓迎します！CONTRIBUTING.mdがある場合はご確認ください。または、変更について話し合うために issue を作成してください。

ライセンス

Apache License, Version 2.0 のもとでライセンスされています。詳細はLICENSEをご覧ください。