Servidor MCP de Govee

Name: Govee MCP Server
Author: mathd

insignia de herrería

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

Related MCP server: OpenHue MCP Server

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.