Mathd Govee MCP Server

🚀 Govee MCP Server

A MCP server for controlling Govee LED devices via the Govee API.

🚀 Quick Start

This is a MCP server that enables you to control Govee LED devices through the Govee API.

📦 Installation

Install via Smithery

Use Smithery to automatically install the Govee MCP Server:

npx -y @smithery/cli install @mathd/govee_mcp_server --client claude

Manual Installation

# Install using pip
pip install .

# Development mode (including test dependencies)
pip install -e ".[test]"

💻 Usage Examples

MCP Server

The MCP server provides several tools for controlling Govee devices via the Model Context Protocol. 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.

Command Line Interface (CLI)

There is a CLI tool that allows you to directly control Govee devices:

# Turn the device on or off
govee-cli power on
govee-cli power off

# Set the 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 the brightness (0 - 100)
govee-cli brightness 50

Run govee-cli --help to view the full command documentation.

🔧 Technical Details

Run Tests

To run the test suite:

# Install test dependencies
pip install -e ".[test]"

# Run all tests
pytest tests/

# Run a specific test file
pytest tests/test_server.py  # Server tests (simulated API calls)
pytest tests/test_cli.py    # CLI tests (actual API calls)

# Run tests with detailed output
pytest tests/ -v

⚠️ Important Note

CLI tests will actually call the real API of your Govee device and control it. Make sure the device is powered on 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 (simulated API)
│   └── test_cli.py     # CLI tests (actual API calls)
└── pyproject.toml      # Project configuration file

Test Coverage

• Server tests: Verify the functionality and performance of the MCP server.
• CLI tests: Test the actual operations and outputs of the command line tool. Through these tests, the stability and reliability of the Govee MCP Server in various scenarios can be ensured.

📚 Documentation

Environment Configuration

Create a .env file in the project root directory and add the following variables:

GOVEE_API_KEY=your_api_key_here
GOVEE_DEVICE_ID=your_device_id_here
GOVEE_SKU=your_device_sku_here

How to obtain these values:

1. Get your API key from the Govee developer console.
2. Use the Govee Home app to find your device ID and SKU.