Skip to main content
Glama
Sign In
enesjakozh

Philips Hue MCP Server

by ThomasRohde
GitHub
Python
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Provides comprehensive control over Philips Hue smart lighting systems, including turning lights on/off, adjusting brightness, changing colors, managing groups, applying scenes, using activity presets, and creating lighting effects.

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

# Install dependencies pip install phue mcp # Run the server python hue_server.py # Install in Claude Desktop mcp install hue_server.py --name "My Hue Lights"

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

  1. Clone este repositorio o descargue el archivo hue_server.py
  2. Instale las dependencias necesarias:
pip install phue mcp

Primera ejecución

  1. Ejecutar el servidor:
python hue_server.py
  1. Cuando se le solicite, presione el botón de enlace en su puente Hue para autorizar la conexión
  2. 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:

mcp install hue_server.py --name "Philips Hue Controller"

Opción 2: Prueba con el Inspector MCP

Para desarrollo y pruebas:

mcp dev hue_server.py

Referencia de API

Recursos

RecursoDescripción
hue://lightsInformación sobre todas las luces
hue://lights/{light_id}Información detallada sobre una luz específica
hue://groupsInformación sobre todos los grupos de luz
hue://groups/{group_id}Información sobre un grupo específico
hue://scenesInformación sobre todas las escenas

Herramientas

HerramientaDescripción
get_all_lightsObtenga información sobre todas las luces
get_lightObtenga información detallada sobre una luz específica
get_all_groupsObtenga información sobre todos los grupos de luz
get_groupObtener información sobre un grupo específico
get_all_scenesObtenga información sobre todas las escenas
turn_on_lightEncender una luz específica
turn_off_lightApagar una luz específica
set_brightnessAjustar el brillo de la luz (0-254)
set_color_rgbEstablecer el color de la luz usando valores RGB
set_color_temperatureEstablecer la temperatura del color de la luz (2000-6500 K)
turn_on_groupEncender todas las luces de un grupo
turn_off_groupApagar todas las luces de un grupo
set_group_brightnessAjustar el brillo del grupo (0-254)
set_group_color_rgbEstablecer el color de todas las luces de un grupo
set_sceneAplicar una escena a un grupo
find_light_by_nameBuscar luces por nombre
create_groupCrear un nuevo grupo de luces
quick_sceneAplicar configuraciones personalizadas para crear una escena
refresh_lightsActualizar la caché de información de luz
set_color_presetAplicar un ajuste preestablecido de color a una luz
set_group_color_presetAplicar un ajuste preestablecido de color a un grupo
alert_lightHaz que la luz parpadee brevemente
set_light_effectEstablecer efectos dinámicos como bucles de color

Indicaciones

InmediatoDescripción
control_lightsControl de luz en lenguaje natural
create_moodConfigurar la iluminación ambiental para las actividades.
light_scheduleConozca las opciones de programación

Ejemplos

Control de luces individuales

# Turn on a light turn_on_light(1) # Set a light to 50% brightness set_brightness(1, 127) # Change a light color to purple set_color_rgb(1, 128, 0, 128) # Set reading mode set_color_preset(1, "reading")

Trabajar con grupos

# Turn off all lights in living room (group 2) turn_off_group(2) # Create a new group create_group("Bedroom", [3, 4, 5]) # Set all kitchen lights to energizing mode set_group_color_preset(3, "energize")

Creando escenas

# Apply an existing scene set_scene(2, "abc123") # Group 2, scene ID abc123 # Create a quick relaxing scene for the living room quick_scene("Evening Relaxation", group_id=2, rgb=[255, 147, 41], brightness=120)

Opciones avanzadas

Ejecute el servidor con configuraciones personalizadas:

python hue_server.py --host 0.0.0.0 --port 8888 --log-level debug

Solución de problemas

  • Puente no encontrado : si el descubrimiento automático no funciona, tienes dos opciones:
    1. Edite manualmente la variable BRIDGE_IP en el script con la dirección IP de su puente
    2. Crear 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.json
      Reemplace "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 autenticarse
  • El control de luz no funciona : use la herramienta refresh_lights para actualizar el caché de información de luz
  • Los 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:

  1. El servidor se autentica con su puente utilizando credenciales almacenadas
  2. Proporciona recursos que describen su configuración de iluminación.
  3. Expone herramientas que Claude puede usar para controlar sus luces.
  4. 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

-
security - not tested
F
license - not found
-
quality - not tested

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.

  1. Tabla de contenido
    1. Descripción general
      1. Características
        1. Inicio rápido
          1. Configuración
            1. Prerrequisitos
            2. Instalación
            3. Primera ejecución
          2. Usando con Claude
            1. Opción 1: Instalar en Claude Desktop
            2. Opción 2: Prueba con el Inspector MCP
          3. Referencia de API
            1. Recursos
            2. Herramientas
            3. Indicaciones
          4. Ejemplos
            1. Control de luces individuales
            2. Trabajar con grupos
            3. Creando escenas
          5. Opciones avanzadas
            1. Solución de problemas
              1. Cómo funciona
                1. Contribuyendo
                  1. Licencia

                    Related MCP Servers

                    • ClickUp MCP Server

                      v4lheru
                      A
                      security
                      A
                      license
                      A
                      quality
                      An enhanced Model Context Protocol server that enables AI assistants to interact with ClickUp workspaces, supporting task relationships, comments, checklists, and workspace management through natural language.
                      Last updated -
                      40
                      376
                      TypeScript
                      MIT License

                    • Home Assistant MCP Server

                      miguelg719
                      -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol server that integrates with Home Assistant to provide smart home control capabilities through natural language, supporting devices like lights, climate systems, locks, alarms, and humidifiers.
                      Last updated -
                      Python
                      MIT License
                      • Apple

                    • Home Assistant MCP

                      hpohlmann
                      -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol (MCP) integration that allows AI assistants to control Home Assistant devices by searching for entities and controlling devices through natural language commands.
                      Last updated -
                      10
                      Python
                      MIT License
                      • Linux
                      • Apple

                    • Hass-MCP

                      voska
                      -
                      security
                      A
                      license
                      -
                      quality
                      A 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 -
                      15
                      Python
                      MIT License
                      • Apple
                      • Linux

                    View all related MCP servers

                    Appeared in Searches

                    New MCP Servers

                    ID: qjq6xe8p1x