remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

The server uses .env files to store configuration variables including the Govee API key, device ID, and SKU.
The server uses pytest for running tests, including server tests with mocked API calls and CLI tests with real API calls.

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を見つけます

インストール

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

テスト範囲

サーバーテストの対象範囲:
- 環境の初期化
- Govee API クライアントメソッド
- サーバーツールとユーティリティ
- エラー処理
CLI テストは、実際の API 呼び出しを実行して Govee デバイスを制御することにより、実際の統合テストを実行します。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

ユーザーは、Govee API を使用して Govee LED デバイスを制御でき、CLI または MCP クライアントを介してデバイスのオン/オフの切り替え、色の設定、明るさの調整などの機能を使用できます。

Related Resources

Reddit Discussion about this server