Govee MCP Server

🚀 Govee MCP サーバー

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

🚀 クイックスタート

この Govee MCP サーバーを使用することで、Govee API を通じて Govee LED デバイスを簡単に制御できます。以下の手順に従ってセットアップしてください。

✨ 主な機能

• Govee API を通じて Govee LED デバイスを制御できます。
• MCP サーバーを介して、Model Context Protocol で Govee デバイスを操作できます。
• コマンドラインインターフェース (CLI) を使用して、直接 Govee デバイスを制御できます。

📦 インストール

Smithery を通じたインストール

Claude デスクトップ版で Govee MCP サーバーを自動インストールするには、Smithery を訪問して以下のコマンドを実行します。

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

手動インストール

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

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

💻 使用例

基本的な使用法

MCP サーバー

MCP サーバーは、Model Context Protocol を通じて Govee デバイスを制御するツールを提供します。Cline やその他の MCP クライアントと一緒に使用できます。 利用可能なツール：

• turn_on_off：LED のオン/オフを切り替えます。
• set_color：RGB 値を使用して LED の色を設定します。
• set_brightness：LED の明るさを設定します。

コマンドラインインターフェース

Govee デバイスを直接制御するための CLI が提供されています。

# デバイスのオン/オフ
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 を実行すると、完全なコマンドドキュメントを表示できます。

🔧 技術詳細

環境変数

ルートディレクトリに .env ファイルを作成し、以下の変数を含めてください。

GOVEE_API_KEY=あなたの_api_key_をここに入力
GOVEE_DEVICE_ID=あなたのデバイス_id_をここに入力
GOVEE_SKU=あなたのデバイス_spu_をここに入力

これらの値を取得する方法：

1. Govee 開発者コンソールであなたの API key を取得します。
2. Govee Home アプリを使用して、あなたのデバイス ID と SKU を見つけます。

開発

テストの実行

テストスイートを実行するには：

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

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

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

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

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

プロジェクト構造

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

テストカバレッジ

• サーバーテストのカバレッジ：

  • 環境の初期化
  • Govee API クライアントのメソッド
  • サーバーのツールとユーティリティ
  • エラー処理

• CLI テストは、実際の API 呼び出しを実行して、あなたの Govee デバイスを制御することでリアルタイムの統合テストを行います。