mcp-philips-hue
MCP server for Philips Hue smart lighting control
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"mcp-philips-hue": {
"args": [
"mcp-philips-hue@1.0.0"
],
"command": "npx"
}
}
}可用工具 （5 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
tavily_search 14 个参数 需填 1 项
Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.
必填参数：query
tavily_extract 6 个参数 需填 1 项
Extract content from URLs. Returns raw page content in markdown or text format.
必填参数：urls
tavily_crawl 11 个参数 需填 1 项
Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.
必填参数：url
tavily_map 8 个参数 需填 1 项
Map a website's structure. Returns a list of URLs found starting from the base URL.
必填参数：url
tavily_research 2 个参数 需填 1 项
Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.
必填参数：input
服务介绍
mcp-philips-hue
An MCP (Model Context Protocol) server for controlling Philips Hue smart lights.
# Features
- get_lights - List all lights connected to your Hue Bridge
- set_brightness - Adjust brightness (0-254) for individual or all lights
- set_color - Change colors using hex codes, color names, or color temperature
- toggle_light - Turn lights on or off
# Prerequisites
- Node.js 18+
- Philips Hue Bridge on your local network
- Hue API key (see setup below)
# Getting Your Hue API Key
- Find your bridge IP at https://discovery.meethue.com/
- Navigate to
http://<bridge-ip>/debug/clip.html - Press the link button on your Hue Bridge
- Within 30 seconds, POST to
/apiwith body:{"devicetype":"mcp-server# user"} - Copy the
usernamefrom the response - this is your API key
# Installation
# # From npm (Recommended)
npx mcp-philips-hue
# # From Source
git clone https://github.com/m2ai-mcp-servers/mcp-philips-hue.git
cd mcp-philips-hue
npm install
npm run build
# Configuration
# # Environment Variables
export HUE_BRIDGE_IP=192.168.1.x
export HUE_API_KEY=your-api-key-here
# # Claude Desktop Configuration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"philips-hue": {
"command": "npx",
"args": ["-y", "mcp-philips-hue"],
"env": {
"HUE_BRIDGE_IP": "192.168.1.x",
"HUE_API_KEY": "your-api-key-here"
}
}
}
}
# Usage Examples
# # List all lights
get_lights
# # Set brightness
set_brightness light_id="1" brightness=200
set_brightness light_id="all" brightness=100
# # Set color
# Using hex color
set_color light_id="1" color="# FF0000"
# Using color name
set_color light_id="1" color="blue"
# Using color temperature
set_color light_id="1" color="warm"
set_color light_id="all" color="2700K"
# # Toggle lights
toggle_light light_id="1" state=true
toggle_light light_id="all" state=false
# Color Options
# # Named Colors
red, green, blue, yellow, orange, purple, pink, white, cyan, magenta
# # Color Temperature
warm(2200K)soft(2500K)neutral(3500K)cool(5000K)daylight(6500K)- Or specify Kelvin directly:
2700K,4000K, etc.
# Development
# Watch mode
npm run dev
# Run tests
npm test
# Build
npm run build
# Testing
npm test
# License
MIT
Built autonomously by GRIMLOCK - Autonomous MCP Server Factory
