# Hue MCP Server

Control Philips Hue lights through VS Code Copilot or Claude Desktop using the Model Context Protocol (MCP).

## Quick Setup

### 1. Prerequisites

- Python 3.13+ with UV package manager
- Hue Bridge IP address (find it in the Hue app or at <https://discovery.meethue.com/>)

### 2. Install Dependencies

```bash
uv sync
```

### 3. Configure Your Bridge IP

Edit `.env` file:

```bash
HUE_BRIDGE_IP=192.168.1.XXX  # Replace with your bridge IP
```

### 4. First-Time Authentication

Press the physical button on your Hue Bridge, then run:

```bash
uv run python -c "from phue import Bridge; Bridge('YOUR_BRIDGE_IP')"
```

## Usage

### For VS Code Copilot

Add to your VS Code MCP configuration file (`mcp.json`):

**Location:** `~/Library/Application Support/Code/User/mcp.json` (macOS)

```json
{
  "mcpServers": {
    "custom-hue": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "__PATH__",
        "python",
        "__PATH_TO_main.py__"
      ],
      "env": {
        "HUE_BRIDGE_IP": "192.168.x.x"
      }
    }
  }
}
```

**Note:** Replace the paths with your actual project path and update `HUE_BRIDGE_IP` with your bridge IP.

After adding the configuration, reload VS Code and use Copilot:

- "Turn on the corner light and set it to blue"
- "List all my lights"
- "Turn off all lights"

### For Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "hue-lights": {
      "command": "uv",
      "args": ["run", "/FULL/PATH/TO/custom-hue/main.py"],
      "env": {
        "HUE_BRIDGE_IP": "192.168.1.XXX"
      }
    }
  }
}
```

## Available Tools

- `change_hue_light` - Control individual lights (brightness, hue, saturation, on/off)
- `list_hue_lights` - List all available lights on your Hue Bridge