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:
To get these values:
Get your API key from the Govee Developer Portal
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):
Manual Installation
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:
Run `govee-cli --help` for full command documentation.
Development
Running Tests
To run the test suite:
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
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.