MCP Wyze Server

🚀 MCP Wyze Server

このプロジェクトは、wyze-sdkライブラリを使用して、Wyzeのスマートホームデバイスを制御するためのMCP（Model Context Protocol）サーバーです。AIアシスタント（Claudeなど）を通じて、Wyzeデバイスとの相互作用を可能にします。

✨ 主な機能

• 認証: Wyze APIの資格情報を使用した安全なログイン
• デバイス検出: すべてのWyzeデバイスの一覧表示と情報取得
• デバイス制御: デバイスのオン/オフ、明るさの調整など
• グループ管理: 部屋全体やデバイスグループを一度に制御
• リアルタイムリソース: デバイスとグループのステータスをリアルタイムで監視
• 自動ログイン: 環境変数を使用したシームレスな認証

📦 インストール

オプション1: PyPIからインストール（推奨）

uv pip install mcp-wyze-server

または、pipを使用する場合:

pip install mcp-wyze-server

オプション2: ソースからインストール

1. リポジトリをクローンします:

git clone https://github.com/aldilaff/mcp-wyze-server.git
cd mcp-wyze-server

2. uvを使用してインストールします:

uv pip install -e .

または、ビルドしてインストールします:

uv build
uv pip install dist/*.whl

環境変数の設定

インストール後、環境変数を設定します:

cp .env.example .env

.envファイルを編集し、Wyzeの資格情報を追加します:

WYZE_EMAIL=your-email@example.com
WYZE_PASSWORD=your-password
WYZE_KEY_ID=your-key-id-here
WYZE_API_KEY=your-api-key-here

Wyze API資格情報の取得

Wyze APIの資格情報を取得するには、以下の手順を実行します:

1. Wyze Developer Portalにアクセスします。
2. 開発者アカウントを持っていない場合は、作成します。
3. 新しいAPIキーを作成します。
4. KEY_IDとAPI_KEYをメモします。

💻 使用例

サーバーを単独で実行する場合

PyPIからインストールした場合:

mcp-wyze-server

ソースから実行する場合:

uv run python src/mcp_wyze_server/server.py

Claude Desktopと統合する場合

Claude DesktopのMCP設定に以下の構成を追加します: pip/uvを介してグローバルにインストールした場合:

{
  "mcpServers": {
    "wyze": {
      "command": "/Users/{yourusername}/.local/bin/uv",
      "args": ["tool", "run", "mcp-wyze-server"],
      "env": {
        "WYZE_EMAIL": "your-email@example.com",
        "WYZE_PASSWORD": "your-password",
        "WYZE_KEY_ID": "your-key-id",
        "WYZE_API_KEY": "your-api-key"
      }
    }
  }
}

注: /Users/yourusername/.local/bin/uvを、実際のuvのインストールパスに置き換えてください。これは、ターミナルでwhich uvを実行することで確認できます。

ソースから実行する場合（開発用に推奨）:

{
  "mcpServers": {
    "wyze": {
      "command": "/Users/yourusername/.local/bin/uv",
      "args": [
        "run",
        "--directory",
        "/path/to/mcp-wyze-server",
        "python",
        "src/mcp_wyze_server/server.py"
      ],
      "env": {
        "WYZE_EMAIL": "your-email@example.com",
        "WYZE_PASSWORD": "your-password",
        "WYZE_KEY_ID": "your-key-id",
        "WYZE_API_KEY": "your-api-key"
      }
    }
  }
}

注: /Users/yourusername/.local/bin/uvを、実際のuvのパスに置き換えてください。

他のMCPクライアントとの構成

このサーバーはstdioトランスポートを使用しており、このプロトコルをサポートする任意のMCPクライアントと統合できます。 PyPIからインストールした場合:

mcp-wyze-server

ソースから実行する場合:

uv run python /path/to/mcp-wyze-server/src/mcp_wyze_server/server.py

📚 ドキュメント

利用可能なMCPツール

認証

• wyze_login() - Wyzeアカウントにログイン（環境変数を使用）

デバイス管理

• wyze_get_devices() - すべてのデバイスを一覧表示
• wyze_device_info(device_mac) - デバイスの詳細情報を取得
• wyze_get_device_status(device_mac) - 正確な現在のステータス（電源状態、明るさなど）を取得

基本的なデバイス制御

• wyze_turn_on_device(device_mac) - デバイスをオンにする
• wyze_turn_off_device(device_mac) - デバイスをオフにする
• wyze_set_brightness(device_mac, brightness) - 明るさを設定（0-100）

高度なライト制御

• wyze_set_color_temp(device_mac, color_temp) - 色温度を設定（2700K-6500K）
• wyze_set_color(device_mac, color) - RGB色を設定（16進形式）
• wyze_set_light_effect(device_mac, effect) - 視覚効果を設定
• wyze_set_light_sun_match(device_mac, enabled) - 太陽光マッチングを有効/無効にする
• wyze_clear_light_timer(device_mac) - 予定されたタイマーをクリアする

スケール管理

• wyze_get_scales() - すべてのWyzeスケールを一覧表示
• wyze_get_scale_info(device_mac) - スケールの詳細情報を取得
• wyze_get_scale_records(device_mac, user_id, days_back) - 体重/体組成の記録を取得

リソース

• wyze://devices - ステータス付きのリアルタイムデバイス一覧
• wyze://scales - 家族メンバー付きのリアルタイムスケール一覧

プロンプト

• wyze_device_control_prompt(device_name, action) - 制御プロンプトを生成
• wyze_scale_health_prompt(family_member_name, timeframe) - 健康分析プロンプトを生成

サポートされるデバイス

このサーバーは、以下を含むさまざまなWyzeデバイスタイプをサポートしています:

• ライト（電球、ライトストリップ）
• スイッチ
• プラグ
• スケール
• 錠前
• カメラ（基本制御）
• サーモスタット
• その他...

🔧 技術詳細

開発に使用されているもの

• FastMCP: 高性能MCPサーバーフレームワーク
• wyze-sdk: Wyzeデバイス用の包括的なPythonインターフェイス
• uv: 高速Pythonパッケージマネージャー

プロジェクト構造

mcp-wyze-server/
├── src/
│   └── mcp_wyze_server/
│       ├── __init__.py
│       └── server.py     # MCPサーバーの実装
├── test_device.py        # デバイステストユーティリティ
├── pyproject.toml        # プロジェクトの依存関係
├── .env.example          # 環境変数のテンプレート
├── CLAUDE.md             # Claudeの開発ガイドライン
├── LICENSE               # MITライセンス
└── README.md             # このファイル

トラブルシューティング

一般的な問題

1. 認証に失敗した場合: Wyzeの資格情報が正しく、APIキーが有効であることを確認してください。
2. デバイスが見つからない場合: デバイスのMACアドレスは大文字と小文字が区別されます。
3. 接続タイムアウトが発生した場合: ネットワーク接続とWyzeサービスのステータスを確認してください。

デバッグモード

デバッグログを有効にするには、環境変数を設定します:

export MCP_DEBUG=true

コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/AmazingFeature)。
3. 変更をコミットします (git commit -m 'Add some AmazingFeature')。
4. ブランチにプッシュします (git push origin feature/AmazingFeature)。
5. プルリクエストを開きます。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。

謝辞

• Wyze SDK の素晴らしいPythonライブラリ
• MCP のModel Context Protocol仕様
• FastMCP のMCPサーバーフレームワーク

免責事項

このプロジェクトは、Wyze Labs, Inc.とは関係がなく、承認もされておらず、後援もされていません。すべての製品名、ロゴ、およびブランドは、それぞれの所有者の財産です。