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:

1. Obtenga su clave API desde el Portal para desarrolladores de Govee

2. Utilice la aplicación Govee Home para encontrar el ID y el SKU de su dispositivo

Related MCP server: ESP RainMaker 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.