Govee MCP Server

# Govee MCP Server [](https://smithery.ai/server/@mathd/govee_mcp_server) An MCP server for controlling Govee LED devices through the Govee API. ## Setup ### Environment Variables Create a `.env` file in the root directory with the following variables: ```bash GOVEE_API_KEY=your_api_key_here GOVEE_DEVICE_ID=your_device_id_here GOVEE_SKU=your_device_sku_here ``` To get these values: 1. Get your API key from the Govee Developer Portal 2. Use the Govee Home app to find your device ID and SKU ## Installation ### Installing via Smithery To install Govee MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@mathd/govee_mcp_server): ```bash npx -y @smithery/cli install @mathd/govee_mcp_server --client claude ``` ### Manual Installation ```bash # Install with pip pip install . # For development (includes test dependencies) pip install -e ".[test]" ``` ## Usage ### MCP Server The MCP server provides tools for controlling Govee devices through the Model Context Protocol. It can be used with Cline or other MCP clients. Available tools: - `turn_on_off`: Turn the LED on or off - `set_color`: Set the LED color using RGB values - `set_brightness`: Set the LED brightness level ### Command Line Interface A CLI is provided for direct control of Govee devices: ```bash # 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 ``` Run `govee-cli --help` for full command documentation. ## Development ### Running Tests To run the test suite: ```bash # 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 ``` Note: The CLI tests make real API calls to your Govee device and will actually control it. Make sure your device is powered and connected before running these tests. ### Project Structure ``` . ├── 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 ``` ### Test Coverage - Server tests cover: - Environment initialization - Govee API client methods - Server tools and utilities - Error handling - CLI tests perform real-world integration testing by executing actual API calls to control your Govee device.