remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

The server uses .env files to store configuration variables including the Govee API key, device ID, and SKU.
The server uses pytest for running tests, including server tests with mocked API calls and CLI tests with real API calls.

Servidor MCP de Govee

Un servidor MCP para controlar dispositivos LED de Govee a través de la API de Govee.

Configuración

Variables de entorno

Cree un archivo .env en el directorio raíz con las siguientes variables:

GOVEE_API_KEY=your_api_key_here
GOVEE_DEVICE_ID=your_device_id_here
GOVEE_SKU=your_device_sku_here

Para obtener estos valores:

Obtenga su clave API desde el Portal para desarrolladores de Govee
Utilice la aplicación Govee Home para encontrar el ID y el SKU de su dispositivo

Instalación

Instalación mediante herrería

Para instalar Govee MCP Server para Claude Desktop automáticamente a través de Smithery :

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

Instalación manual

# Install with pip
pip install .

# For development (includes test dependencies)
pip install -e ".[test]"

Uso

Servidor MCP

El servidor MCP proporciona herramientas para controlar dispositivos Govee mediante el Protocolo de Contexto de Modelo. Se puede usar con Cline u otros clientes MCP.

Herramientas disponibles:

turn_on_off : Enciende o apaga el LED
set_color : Establece el color del LED usando valores RGB
set_brightness : Establece el nivel de brillo del LED

Interfaz de línea de comandos

Se proporciona una CLI para el control directo de los dispositivos Govee:

# 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

Ejecute govee-cli --help para obtener la documentación completa del comando.

Desarrollo

Ejecución de pruebas

Para ejecutar el conjunto de pruebas:

# 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

Nota: Las pruebas CLI realizan llamadas API reales a su dispositivo Govee y lo controlarán. Asegúrese de que su dispositivo esté encendido y conectado antes de ejecutar estas pruebas.

Estructura del proyecto

.
├── 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

Cobertura de la prueba

Las pruebas del servidor cubren:
- Inicialización del entorno
- Métodos de cliente de la API de Govee
- Herramientas y utilidades de servidor
- Manejo de errores
Las pruebas CLI realizan pruebas de integración en el mundo real ejecutando llamadas API reales para controlar su dispositivo Govee.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Permite a los usuarios controlar dispositivos LED Govee utilizando la API de Govee, con funciones para encender/apagar dispositivos, configurar colores y ajustar el brillo a través de una CLI o clientes MCP.

Related Resources

Reddit Discussion about this server