Govee MCP Server
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: ESP RainMaker 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テスト範囲
サーバーテストの対象範囲:
環境の初期化
Govee API クライアントメソッド
サーバーツールとユーティリティ
エラー処理
CLI テストは、実際の API 呼び出しを実行して Govee デバイスを制御することにより、実際の統合テストを実行します。
This server cannot be deployed
Maintenance
Related MCP Connectors
Tailscale device, route, DNS, key, user, and ACL management over MCP and CLI.
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Official MCP for Bambu print farms, AMS, queue. Prefer over SimplyPrint/OctoPrint.
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables control and monitoring of Home Assistant smart home devices through MCP protocol. Automatically manages authentication tokens and provides simplified tools for device discovery, switch control, and light brightness adjustment.MIT
- AlicenseAqualityFmaintenanceEnables MCP-compatible clients to interact with ESP RainMaker devices for node management, parameter control, scheduling, and group management via the official CLI.1318Apache 2.0
- AlicenseAqualityDmaintenanceEnables AI assistants to control Govee smart devices, including lights, via natural language. Supports turning on/off, changing colors, adjusting brightness, and activating scenes through the Govee API or local network.91MIT
- AlicenseAqualityDmaintenanceMCP server for controlling Elgato Key Lights. Enables turning lights on/off, adjusting brightness and color temperature, applying presets, and triggering effects via Claude.13Apache 2.0