Mathd Govee MCP Server

Govee APIを通じてLED機器を制御するMCPサーバープロジェクト

家庭自動化とIoT 開発者ツール #スマートホーム #LED制御 #APIサービス .Python

スコア : 2ポイント

ダウンロード数 : 15

更新時間 : 2025-04-28

Govee MCPサーバーとは？

Govee MCPサーバーはミドルウェアサービスで、簡単なコマンドまたはAPI呼び出しを通じて、GoveeブランドのスマートLED機器を遠隔で制御できます。これは、あなたの制御端末（携帯電話やパソコンなど）とGoveeのクラウドサービスをつなぐ橋渡しの役割を果たします。

Govee MCPサーバーをどのように使用するか？

2つの方法で使用できます：1) MCPクライアント（Claude Desktopなど）をインストールし、自然言語で制御する；2) 提供されたコマンドラインツールを使用して直接制御コマンドを送信する。

適用シーン

スマートホーム自動化、遠隔照明制御、シーン照明設定（映画モード、読書モードなど）、および他のスマート機器との連動制御に適しています。

主要機能

電源制御Govee LED機器を遠隔でオンオフします。

色制御RGB値（0 - 255の範囲）でライトの色を設定します。

明るさ調整ライトの明るさを細かく調整します（0 - 100%）。

利点と制限

利点

追加のハードウェアを必要とせず、ソフトウェアで直接制御できます。

複数の制御方法（API/CLI/MCP）をサポートします。

軽量で、既存のスマートホームシステムに簡単に統合できます。

制限

安定したネットワーク接続が必要です。

Goveeブランドの互換機器のみをサポートします。

一部の旧型機器では機能が制限される場合があります。

使い方

API資格情報を取得する

Govee開発者ポータルからAPIキーを取得し、Govee Homeアプリで機器IDとSKUを見つけます。

環境を設定する

.envファイルを作成し、資格情報を入力します。

サービスをインストールする

Smitheryを使ってワンクリックでインストールするか、Pythonパッケージを手動でインストールします。

使用を開始する

MCPクライアントまたはコマンドラインツールを使って機器を制御します。

使用例

朝に自動でライトをオンにする朝に自動でライトをオンにし、柔らかい黄色に設定するタイマータスクを設定します。

映画モード映画を見るのに適した照明雰囲気をワンクリックで設定します。

読書モード目を保護するために照明設定を最適化します。

よくある質問

機器IDとSKUをどこで見つけることができますか？

コマンドが機能しないのはなぜですか？

どのGovee機器がサポートされていますか？

複数の機器を制御できますか？

🚀 Govee MCP サーバー

Govee API を通じて Govee LED デバイスを制御するための MCP サーバーです。

🚀 クイックスタート

このサーバーを使用することで、Govee LED デバイスを簡単に制御することができます。以下の手順に従って、環境を設定し、サーバーを起動しましょう。

✨ 主な機能

MCP サーバーを通じて、Govee デバイスを制御するための様々なツールを提供します。
コマンドラインインターフェイス (CLI) を通じて、直接 Govee デバイスを制御することができます。

📦 インストール

環境設定

プロジェクトのルートディレクトリに .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 を見つけます。

インストール方法

Smithery を使用したインストール

Smithery を使用して、Govee MCP サーバーを自動的にインストールします。

npx -y @smithery/cli install @mathd/govee_mcp_server --client claude

手動インストール

# pip を使用してインストール
pip install .

# 開発モード（テスト依存関係を含む）
pip install -e ".[test]"

💻 使用例

MCP サーバー

MCP サーバーは、Model Context Protocol を通じて Govee デバイスを制御するためのいくつかのツールを提供します。利用可能なツール：

turn_on_off：LED をオンまたはオフにします。
set_color：RGB 値を使用して LED の色を設定します。
set_brightness：LED の明るさを設定します。

コマンドラインインターフェイス (CLI)

CLI ツールを使用して、直接 Govee デバイスを制御することができます。

# デバイスをオンまたはオフにする
govee-cli power on
govee-cli power off

# RGB 値（0-255）を使用して色を設定する
govee-cli color 255 0 0   # 赤色
govee-cli color 0 255 0   # 緑色
govee-cli color 0 0 255   # 青色

# 明るさを設定する（0-100）
govee-cli brightness 50

govee-cli --help を実行すると、完全なコマンドドキュメントを表示できます。

🔧 技術詳細

テストの実行

テストスイートを実行するには、以下のコマンドを使用します。

# テスト依存関係をインストール
pip install -e ".[test]"

# すべてのテストを実行
pytest tests/

# 特定のテストファイルを実行
pytest tests/test_server.py  # サーバーテスト（API 呼び出しを模擬）
pytest tests/test_cli.py    # CLI テスト（実際の API 呼び出し）

# 詳細な出力でテストを実行
pytest tests/ -v

⚠️ 重要な注意 CLI テストは、実際に Govee デバイスの API を呼び出し、デバイスを制御します。これらのテストを実行する前に、デバイスが通電され、接続されていることを確認してください。

プロジェクト構造

.
├── src/govee_mcp_server/
│   ├── __init__.py
│   ├── server.py    # MCP サーバーの実装
│   └── cli.py       # コマンドラインインターフェイス
├── tests/
│   ├── test_server.py  # サーバーテスト（API を模擬）
│   └── test_cli.py     # CLI テスト（実際の API 呼び出し）
└── pyproject.toml      # プロジェクトの設定ファイル