govee_mcp_server

govee_mcp_server

3
os_automation

The Govee MCP Server is designed to control Govee LED devices via the Govee API using Model Context Protocol. It features a command-line interface for direct device control and supports various operations like turning devices on/off and setting colors or brightness.

Govee MCP Server

An MCP server for controlling Govee LED devices through the Govee API.

Setup

  • Create a .env file with GOVEE_API_KEY, GOVEE_DEVICE_ID, and GOVEE_SKU.
  • Obtain these values from the Govee Developer Portal and Govee Home app.

Installation

Installing via Smithery

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

Manual Installation

  • Install with pip install . or for development with pip install -e "[test]".

Usage

MCP Server

  • Tools available: turn_on_off, set_color, set_brightness.

Command Line Interface

  • Control devices with commands like govee-cli power on or govee-cli color 255 0 0.
  • Run govee-cli --help for full documentation.

Development

Running Tests

  • Use pytest to run tests.

Project Structure

  • Overview of project files and their purpose.

Test Coverage

  • Tests cover environment setup, API methods, server tools, and CLI integration.