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

license - permissive license

quality - not tested

How are these scores calculated?

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.

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

Related MCP Servers

HomeAssistant MCP
jango-blockchained
-
security
A
license
-
quality
Smart Device Control 🎮 💡 Lights: Brightness, color, RGB 🌡️ Climate: Temperature, HVAC, humidity 🚪 Covers: Position and tilt 🔌 Switches: On/off 🚨 Sensors: State monitoring Intelligent Organization 🏠 Grouping with context awareness. Robust Architecture 🛠️ Error handling, state validation ...
Last updated -
6
24
TypeScript
Apache 2.0
OpenHue MCP Server
lsemenenko
A
security
A
license
A
quality
Enables control of Philips Hue lights through Claude and other LLM interfaces using the OpenHue CLI.
Last updated -
6
8
TypeScript
MIT License
Google Home MCP Server
jmagar
-
security
F
license
-
quality
Enables users to control Google Home smart plugs using the Smart Home API with OAuth2 authentication, offering real-time device state management and control operations.
Last updated -
1
TypeScript
SwitchBot MCP Server
genm
A
security
A
license
A
quality
Enables AI assistants to control SwitchBot devices, providing functionalities like device management, scene execution, and sensor information monitoring through the SwitchBot API.
Last updated -
3
3
JavaScript
ISC License

View all related MCP servers

Govee MCP Server