Fibaro HC3 MCP Server

# Fibaro HC3 MCP Server > **⚠️ DEMO VERSION DISCLAIMER** > This is a **demonstration/educational version** of the Fibaro HC3 MCP Server. It is **NOT a commercial product** and is provided as-is for learning and testing purposes only. Use at your own risk. An MCP (Model Context Protocol) Server for controlling Fibaro Home Center 3 through Claude AI. ## Features - **Auto-connect** to Fibaro HC3 on startup (one-time configuration) - Retrieve information about devices, scenes, and rooms - Control devices (turn on/off, set values, brightness, colors) - Run and stop scenes - Full Claude AI integration for natural language control - Support for RGB lights with color name mapping - HTTP/HTTPS protocol support ## Installation ### 🚀 Quick Installation (Recommended) **One-command installation** - no need to clone the repository: ```bash curl -sSL https://raw.githubusercontent.com/kaeljune/fibaro-mcp-server/main/quick-install.sh | bash ``` This script will: - ✅ Check dependencies (git, node.js, npm) - ✅ Choose your AI client (Claude Desktop or Cursor) - ✅ Automatically clone the repository - ✅ Ask for Fibaro HC3 connection details - ✅ Test the connection - ✅ Install dependencies and build the project - ✅ Configure your AI client automatically - ✅ Ready to use! ### 📋 Manual Installation If you prefer to install manually: 1. Clone this repository: ```bash git clone https://github.com/kaeljune/fibaro-mcp-server.git cd fibaro-mcp-server ``` 2. Install dependencies: ```bash npm install ``` 3. Build the project: ```bash npm run build ``` 4. Run the configuration script: ```bash ./install-claude.sh ``` ## Usage After installation, **no manual connection required**. The MCP server will automatically connect to Fibaro HC3 when your AI client (Claude Desktop or Cursor) starts. ### Supported AI Clients - **Claude Desktop** - Full MCP support - **Cursor** - MCP integration for AI-powered coding ### 1. View Device List ``` Show all devices ``` ### 2. Control Lights ``` Turn off light number 3 ``` ``` Turn on living room light ``` ``` Set light number 5 brightness to 50% ``` ### 3. Control RGB Lights ``` Change RGB light number 10 to red ``` ``` Set RGB light number 10 to purple (255,0,255,0) ``` ### 4. Run Scenes ``` Run scene "Good Night" ``` ## Available Commands ### Information - `fibaro_get_devices`: Get list of all devices - `fibaro_get_device`: Get detailed device information by ID - `fibaro_get_scenes`: Get list of all scenes - `fibaro_get_scene`: Get detailed scene information by ID - `fibaro_get_rooms`: Get list of all rooms ### Control - `fibaro_turn_on_device`: Turn on device by ID - `fibaro_turn_off_device`: Turn off device by ID - `fibaro_set_device_value`: Set property value for device - `fibaro_set_brightness`: Set brightness for lights/dimmers (0-100%) - `fibaro_set_color`: Set RGB color for RGB lights (R,G,B,W: 0-255) - `fibaro_control_rgb_light`: Complete RGB light control (on/off + color + brightness) - `fibaro_run_scene`: Run scene by ID - `fibaro_stop_scene`: Stop scene by ID ## Integration Examples After configuration, you can talk to Claude like: - "Turn off all lights in the house" - "Turn on bedroom light" - "Run good morning scene" - "Show status of all sensors" - "Set living room light brightness to 50%" - "Change living room RGB light to green" - "Set RGB light number 5 to light purple" Claude will automatically: 1. Connect to Fibaro HC3 (if not already connected) 2. Find matching devices/scenes 3. Execute control commands 4. Report results ## Security - This server only connects locally to Fibaro HC3 - Login credentials are stored securely in MCP configuration - Supports both HTTP and HTTPS with self-signed certificate acceptance - No sensitive information is stored in logs ## Troubleshooting ### Cannot connect to Fibaro HC3 - Re-run the installation script: `./install-claude.sh` - Check IP address and port (default HTTP: 80, HTTPS: 443) - Ensure username/password are correct - Check firewall and network connectivity - Try accessing HC3 web interface from browser ### MCP Server not working - Check the path in Claude configuration - Ensure project has been built (`npm run build`) - Restart Claude Desktop after configuration changes - Check Claude Desktop logs for detailed error messages ### Changing Fibaro HC3 connection information To change IP, username, or password: 1. Re-run the installation script: `./install-claude.sh` 2. Enter new information 3. Restart Claude Desktop ## License This is a demo/educational project. Not for commercial use.