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