Mathd Govee MCP Server

🚀 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

これらの値を取得する方法は以下の通りです。

1. Govee 開発者コンソールから API キーを取得します。
2. 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      # プロジェクトの設定ファイル

テストカバレッジ

• サーバーテスト：MCP サーバーの機能とパフォーマンスを検証します。
• CLI テスト：コマンドラインツールの実際の操作と出力をテストします。 これらのテストにより、Govee MCP サーバーがさまざまなシナリオで安定して動作することを保証します。