A
securityA
licenseA
qualityIntegrate Claude with Any OpenAI SDK Compatible Chat Completion API - OpenAI, Perplexity, Groq, xAI, PyroPrompts and more.
Last updated -
1
27
140
MIT License
Servidor MCP OpenHue
Un servidor MCP que permite el control de las luces Philips Hue a través de Claude y otras interfaces LLM utilizando la CLI de OpenHue.
Prerrequisitos
Node.js (v16 o superior)
Claude para escritorio (opcional, para pruebas)
Configuración del puente
Antes de utilizar el servidor, debe configurar la CLI de OpenHue con su Hue Bridge:
Ejecute el comando de configuración:
# On Linux/macOS:
docker run -v "${HOME}/.openhue:/.openhue" --rm --name=openhue -it openhue/cli setup
# On Windows (PowerShell):
docker run -v "${env:USERPROFILE}\.openhue:/.openhue" --rm --name=openhue -it openhue/cli setup
Siga las instrucciones en pantalla:
La CLI buscará su Hue Bridge
Presione el botón de enlace en su Hue Bridge cuando se le solicite
Espere la confirmación de que la configuración está completa
Verifique la configuración enumerando sus luces:
# On Linux/macOS:
docker run -v "${HOME}/.openhue:/.openhue" --rm --name=openhue -it openhue/cli get lights
# On Windows (PowerShell):
docker run -v "${env:USERPROFILE}\.openhue:/.openhue" --rm --name=openhue -it openhue/cli get lights
Si ve sus luces en la lista, la configuración está completa y está listo para usar el servidor MCP.
Instalación
Clonar el repositorio:
git clone <your-repo-url>
cd claude-mcp-openhue
Instalar dependencias:
npm install
Construir el proyecto:
npm run build
Ejecutar el servidor:
npm start
Características
Este servidor expone las siguientes capacidades a través de MCP:
Control de luces
Enumere todas las luces u obtenga detalles de luces específicas
Encender/apagar las luces
Ajustar el brillo
Establecer colores
Controlar la temperatura del color
Control de la habitación
Enumere todas las habitaciones u obtenga detalles de las habitaciones
Controlar todas las luces de una habitación a la vez
Establecer el brillo y los colores en toda la habitación
Gestión de escenas
Lista de escenas disponibles
Activar escenas con diferentes modos
Filtrar escenas por habitación
Uso con Claude Desktop
Abra el archivo de configuración de Claude Desktop:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonVentanas:
%APPDATA%\Claude\claude_desktop_config.json
Agregue la configuración del servidor:
{
"mcpServers": {
"hue": {
"command": "node",
"args": ["/absolute/path/to/build/index.js"]
}
}
}
Reiniciar Claude Desktop
Busque el ícono del martillo para verificar que el servidor esté conectado
Comandos de ejemplo
Una vez conectado, puedes hacerle a Claude preguntas en lenguaje natural como:
¿Qué luces tengo en la sala?
"Enciende todas las luces de la cocina"
"Ajusta las luces del dormitorio al 50% de brillo"
"Cambia las luces de la oficina a azules"
Activa la escena 'Relajante'
"¿Qué escenas están disponibles en el estudio?"
Herramientas disponibles
obtener luces
Enumera todas las luces u obtiene detalles de luces específicas
{
lightId?: string; // Optional light ID or name
room?: string; // Optional room name filter
}
luz de control
Controla luces individuales
{
target: string; // Light ID or name
action: "on" | "off";
brightness?: number; // 0-100
color?: string; // Color name
temperature?: number; // 153-500 Mirek
}
conseguir habitaciones
Enumera todas las habitaciones u obtiene detalles específicos de cada habitación
{
roomId?: string; // Optional room ID or name
}
sala de control
Controla todas las luces de una habitación.
{
target: string; // Room ID or name
action: "on" | "off";
brightness?: number;
color?: string;
temperature?: number;
}
escenas de obtención
Enumera las escenas disponibles
{
room?: string; // Optional room name filter
}
activar escena
Activa una escena específica
{
name: string; // Scene name or ID
room?: string; // Optional room name
mode?: "active" | "dynamic" | "static";
}
Desarrollo
Estructura del proyecto
.
├── src/
│ └── index.ts # Main server implementation
├── build/ # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md
Edificio
npm run build
Correr
npm start
Solución de problemas
El servidor no se conecta
Comprueba que Docker se esté ejecutando
Verificar que exista la configuración de OpenHue
Consultar los registros de Claude Desktop
Intente ejecutar OpenHue CLI directamente
Fallos de comando
Comprobar los permisos de la CLI de OpenHue
Verificar los nombres de luces/habitaciones/escenas
Comprobar los registros del contenedor Docker
Verificar la conectividad del Hue Bridge
Licencia
Licencia MIT
Contribuyendo
Bifurcar el repositorio
Crea tu rama de funciones
Confirme sus cambios
Empujar hacia la rama
Crear una nueva solicitud de extracción
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Permite el control de las luces Philips Hue a través de Claude y otras interfaces LLM utilizando la CLI de OpenHue.
Related MCP Servers
- -securityAlicense-qualityEnables users to control Govee LED devices using the Govee API, with features for turning devices on/off, setting colors, and adjusting brightness through a CLI or MCP clients.Last updated -3MIT License
- -securityFlicense-qualityA Model Context Protocol interface that enables AI assistants like Claude to control Philips Hue smart lighting systems through natural language commands.Last updated -10
- -securityAlicense-qualityEnables Claude to interact with Qlik Cloud applications and extract data from visualizations through the Qlik Cloud API.Last updated -5MIT License