Govee MCP Server

Govee MCP Server

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

これらの値を取得するには：

1. Govee Developer Portal から API キーを取得します
2. Govee Home アプリを使用して、デバイス ID と SKU を確認します

インストール

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 サーバーは、Model Context Protocol を通じて 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 デバイスを制御し、実環境での統合テストを行います。