Govee MCP サーバー
Govee API を介して Govee LED デバイスを制御するための MCP サーバー。
設定
環境変数
次の変数を含む.envファイルをルート ディレクトリに作成します。
GOVEE_API_KEY=your_api_key_here
GOVEE_DEVICE_ID=your_device_id_here
GOVEE_SKU=your_device_sku_here
これらの値を取得するには:
Govee開発者ポータルからAPIキーを取得します
Govee Homeアプリを使用してデバイスIDとSKUを見つけます
Related MCP server: OpenHue MCP Server
インストール
Smithery経由でインストール
Smithery経由で Claude Desktop 用の Govee MCP Server を自動的にインストールするには:
npx -y @smithery/cli install @mathd/govee_mcp_server --client claude
手動インストール
# Install with pip
pip install .
# For development (includes test dependencies)
pip install -e ".[test]"
使用法
MCPサーバー
MCPサーバーは、モデルコンテキストプロトコルを介してGoveeデバイスを制御するためのツールを提供します。Clineやその他のMCPクライアントで使用できます。
利用可能なツール:
turn_on_off: LEDのオン/オフを切り替えるset_color: RGB値を使用してLEDの色を設定するset_brightness: LEDの明るさレベルを設定する
コマンドラインインターフェース
Govee デバイスを直接制御するための CLI が提供されています。
# Turn device on/off
govee-cli power on
govee-cli power off
# Set color using RGB values (0-255)
govee-cli color 255 0 0 # Red
govee-cli color 0 255 0 # Green
govee-cli color 0 0 255 # Blue
# Set brightness (0-100)
govee-cli brightness 50
完全なコマンドドキュメントについてはgovee-cli --helpを実行してください。
発達
テストの実行
テスト スイートを実行するには:
# Install test dependencies
pip install -e ".[test]"
# Run all tests
pytest tests/
# Run specific test files
pytest tests/test_server.py # Server tests (mocked API calls)
pytest tests/test_cli.py # CLI tests (real API calls)
# Run tests with verbose output
pytest tests/ -v
注: CLIテストはGoveeデバイスに対して実際のAPI呼び出しを行い、実際にデバイスを制御します。テストを実行する前に、デバイスの電源がオンで接続されていることを確認してください。
プロジェクト構造
.
├── src/govee_mcp_server/
│ ├── __init__.py
│ ├── server.py # MCP server implementation
│ └── cli.py # Command-line interface
├── tests/
│ ├── test_server.py # Server tests (with mocked API)
│ └── test_cli.py # CLI tests (real API calls)
└── pyproject.toml # Project configuration
テスト範囲
サーバーテストの対象範囲:
環境の初期化
Govee API クライアントメソッド
サーバーツールとユーティリティ
エラー処理
CLI テストは、実際の API 呼び出しを実行して Govee デバイスを制御することにより、実際の統合テストを実行します。