Servidor MCP Philips Hue
Una potente interfaz de Protocolo de Contexto de Modelo (MCP) para controlar los sistemas de iluminación inteligente Philips Hue.
Tabla de contenido
Descripción general
Este servidor utiliza el Protocolo de Contexto de Modelo (MCP) para ofrecer una integración fluida entre asistentes de IA como Claude y tu sistema de iluminación Philips Hue. Con él, puedes controlar tus luces inteligentes con lenguaje natural, acceder a información detallada sobre la iluminación y crear configuraciones avanzadas mediante una interfaz estandarizada y compatible con IA.
Características
Control completo de la luz : enciende/apaga, ajusta el brillo, cambia los colores, establece la temperatura del color
Gestión integral de grupos : controle varias luces juntas, cree grupos personalizados
Manejo de escenas : aplique escenas existentes, cree escenas de iluminación personalizadas rápidamente
Ajustes predefinidos basados en actividades : configuraciones listas para usar para lectura, relajación, concentración y más
Efectos especiales : acceda a efectos de iluminación dinámicos como bucles de color
Control del lenguaje natural : indicaciones especializadas para el control de la iluminación a través de la conversación
Integración local segura : se conecta directamente a su puente Hue en su red local
Inicio rápido
Luego, en Claude, comienza con: "Me gustaría controlar mis luces Philips Hue. ¿Puedes mostrarme qué luces tengo disponibles?"
Configuración
Prerrequisitos
Python 3.9+
Un puente Philips Hue en su red local
Luces Philips Hue emparejadas con tu puente
Instalación
Clone este repositorio o descargue el archivo
hue_server.py
Instale las dependencias necesarias:
Primera ejecución
Ejecutar el servidor:
Cuando se le solicite, presione el botón de enlace en su puente Hue para autorizar la conexión
Sus detalles de conexión se guardarán en
~/.hue-mcp/config.json
para uso futuro
Usando con Claude
Opción 1: Instalar en Claude Desktop
Si tienes instalado Claude Desktop:
Opción 2: Prueba con el Inspector MCP
Para desarrollo y pruebas:
Referencia de API
Recursos
Recurso | Descripción |
| Información sobre todas las luces |
| Información detallada sobre una luz específica |
| Información sobre todos los grupos de luz |
| Información sobre un grupo específico |
| Información sobre todas las escenas |
Herramientas
Herramienta | Descripción |
| Obtenga información sobre todas las luces |
| Obtenga información detallada sobre una luz específica |
| Obtenga información sobre todos los grupos de luz |
| Obtener información sobre un grupo específico |
| Obtenga información sobre todas las escenas |
| Encender una luz específica |
| Apagar una luz específica |
| Ajustar el brillo de la luz (0-254) |
| Establecer el color de la luz usando valores RGB |
| Establecer la temperatura del color de la luz (2000-6500 K) |
| Encender todas las luces de un grupo |
| Apagar todas las luces de un grupo |
| Ajustar el brillo del grupo (0-254) |
| Establecer el color de todas las luces de un grupo |
| Aplicar una escena a un grupo |
| Buscar luces por nombre |
| Crear un nuevo grupo de luces |
| Aplicar configuraciones personalizadas para crear una escena |
| Actualizar la caché de información de luz |
| Aplicar un ajuste preestablecido de color a una luz |
| Aplicar un ajuste preestablecido de color a un grupo |
| Haz que la luz parpadee brevemente |
| Establecer efectos dinámicos como bucles de color |
Indicaciones
Inmediato | Descripción |
| Control de luz en lenguaje natural |
| Configurar la iluminación ambiental para las actividades. |
| Conozca las opciones de programación |
Ejemplos
Control de luces individuales
Trabajar con grupos
Creando escenas
Opciones avanzadas
Ejecute el servidor con configuraciones personalizadas:
Solución de problemas
Puente no encontrado : si el descubrimiento automático no funciona, tienes dos opciones:
Edite manualmente la variable
BRIDGE_IP
en el script con la dirección IP de su puenteCrear manualmente un archivo de configuración:
# Create the config directory mkdir -p ~/.hue-mcp # Create a config.json file with your bridge IP echo '{"bridge_ip": "192.168.1.x"}' > ~/.hue-mcp/config.jsonReemplace "192.168.1.x" con la dirección IP real de su puente Hue
Problemas de conexión : elimine
~/.hue-mcp/config.json
y reinicie el servidor para volver a autenticarseEl control de luz no funciona : use la herramienta
refresh_lights
para actualizar el caché de información de luzLos grupos o escenas no aparecen : reinicie el puente y el servidor para sincronizar todos los datos
Cómo funciona
Este servidor se conecta a tu puente Philips Hue mediante la biblioteca de Python phue
y expone su funcionalidad mediante el Protocolo de Contexto de Modelo. Cuando una IA como Claude se conecta:
El servidor se autentica con su puente utilizando credenciales almacenadas
Proporciona recursos que describen su configuración de iluminación.
Expone herramientas que Claude puede usar para controlar sus luces.
Ofrece indicaciones que ayudan a Claude a comprender cómo interactuar con las luces.
Toda la comunicación con su sistema Hue ocurre localmente dentro de su red para mayor seguridad y privacidad.
Contribuyendo
¡Agradecemos sus contribuciones! Siéntase libre de:
Informar errores y sugerir funciones en el rastreador de problemas
Enviar solicitudes de extracción con mejoras
Comparta ejemplos de cómo está utilizando esto con la configuración de su hogar inteligente.
Licencia
Este proyecto está disponible bajo la licencia MIT.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Una interfaz de protocolo de contexto de modelo que permite a los asistentes de IA como Claude controlar los sistemas de iluminación inteligente Philips Hue a través de comandos de lenguaje natural.
Related MCP Servers
- AsecurityAlicenseAqualityEnables control of Philips Hue lights through Claude and other LLM interfaces using the OpenHue CLI.Last updated -69MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants like Claude to interact directly with Home Assistant, allowing them to query device states, control smart home entities, and perform automation tasks.Last updated -12197MIT License
- AsecurityAlicenseAqualityA Model Context Protocol service that enables remote management and control of NodeMCU/ESP8266 IoT devices with AI assistant integration through Claude Desktop.Last updated -41MIT License
- -securityFlicense-qualityA Model Context Protocol (MCP) server that allows AI assistants like Claude to control real smart bulbs via UDP network communication, featuring voice commands, AI reasoning, and direct hardware control.Last updated -1