Openhue

🚀 OpenHue MCP Server

An MCP server that enables control of Philips Hue lights via OpenHue CLI and supports interaction with Claude and other LLM interfaces.

🚀 Quick Start

Prerequisites

• Node.js (v16 or higher)
• Docker
• Claude Desktop (Optional, for testing)

Bridge Setup

Before using the server, you need to set up your Hue bridge via OpenHue CLI:

1. Run the installation command:

# 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

2. Follow the on-screen instructions:

   • The CLI will search for your Hue bridge.
   • Press the link button on your Hue bridge when prompted.
   • Wait for confirmation that the setup is complete.

3. Verify by listing the lights:

# 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

If you see a list of lights, the setup is complete, and you can start using the MCP server.

Installation

1. Clone the repository:

git clone <your-repo-url>
cd claude-mcp-openhue

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Run the server:

npm start

✨ Features

This server provides the following functions through MCP:

Light Control

• List information about all lights or specified lights.
• Turn lights on/off.
• Adjust brightness and color.

Room Control

• Get room information.
• Get the status of all lights in a room.
• Control the lights in a room.

Scene Management

• Create, delete, and update scenes.
• List all scenes.
• Apply a specified scene.

📚 Documentation

Project Structure

.
├── src/
│   └── index.ts    # Main server implementation file
├── build/          # Compiled JavaScript folder
├── package.json
├── tsconfig.json
└── README.md

Build

npm run build

Run

npm start

🔧 Troubleshooting

Server Cannot Connect

1. Check if Docker is running.
2. Verify the existence of the OpenHue configuration.
3. Check the Claude Desktop logs.
4. Try running the OpenHue CLI directly.

Command Fails

1. Check the OpenHue CLI permissions.
2. Confirm that the light/room/scene names are correct.
3. Check the Docker container logs.
4. Verify the Hue bridge connectivity.

📄 License

MIT License

💪 Contribution

1. Fork the repository.
2. Create a feature branch.
3. Commit your changes.
4. Push to the branch.
5. Open a new Pull Request.