Fibaro MCP Server

🚀 Fibaro HC3 MCP 服務器

Fibaro HC3 MCP 服務器是一個藉助 Claude AI 來控制 Fibaro Home Center 3 的服務器。它能讓用戶通過自然語言方便地與 Fibaro 智能家居系統進行交互，實現設備控制、場景運行等功能。

🚀 快速開始

安裝完成後，無需手動連接。當您的 AI 客戶端（Claude Desktop 或 Cursor）啟動時，MCP 服務器將自動連接到 Fibaro HC3。

✨ 主要特性

• 自動連接：啟動時自動連接到 Fibaro HC3（僅需一次性配置）
• 信息檢索：可獲取設備、場景和房間的相關信息
• 設備控制：能夠控制設備的開關、設置數值、亮度和顏色等
• 場景管理：支持運行和停止場景
• Claude AI 集成：實現自然語言控制
• RGB 燈支持：支持 RGB 燈，並具備顏色名稱映射功能
• 協議支持：支持 HTTP/HTTPS 協議

📦 安裝指南

🚀 快速安裝（推薦）

一鍵安裝 - 無需克隆倉庫：

curl -sSL https://raw.githubusercontent.com/kaeljune/fibaro-mcp-server/main/quick-install.sh | bash

此腳本將完成以下操作：

• ✅ 檢查依賴項（git、node.js、npm）
• ✅ 選擇您的 AI 客戶端（Claude Desktop 或 Cursor）
• ✅ 自動克隆倉庫
• ✅ 詢問 Fibaro HC3 連接詳情
• ✅ 測試連接
• ✅ 安裝依賴項並構建項目
• ✅ 自動配置您的 AI 客戶端
• ✅ 安裝完成，即可使用！

📋 手動安裝

如果您傾向於手動安裝，請按以下步驟操作：

1. 克隆此倉庫：

git clone https://github.com/kaeljune/fibaro-mcp-server.git
cd fibaro-mcp-server

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

4. 運行配置腳本：

./install-claude.sh

💻 使用示例

基礎用法

1. 查看設備列表

Show all devices

2. 控制燈光

Turn off light number 3

Turn on living room light

Set light number 5 brightness to 50%

3. 控制 RGB 燈光

Change RGB light number 10 to red

Set RGB light number 10 to purple (255,0,255,0)

4. 運行場景

Run scene "Good Night"

高級用法

配置完成後，您可以與 Claude 進行如下對話：

• "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 將自動完成以下操作：

1. 連接到 Fibaro HC3（若尚未連接）
2. 查找匹配的設備/場景
3. 執行控制命令
4. 報告結果

📚 詳細文檔

可用命令

信息類

• fibaro_get_devices：獲取所有設備列表
• fibaro_get_device：通過 ID 獲取詳細設備信息
• fibaro_get_scenes：獲取所有場景列表
• fibaro_get_scene：通過 ID 獲取詳細場景信息
• fibaro_get_rooms：獲取所有房間列表

控制類

• fibaro_turn_on_device：通過 ID 打開設備
• fibaro_turn_off_device：通過 ID 關閉設備
• fibaro_set_device_value：設置設備屬性值
• fibaro_set_brightness：設置燈光/調光器的亮度（0 - 100%）
• fibaro_set_color：為 RGB 燈設置 RGB 顏色（R,G,B,W: 0 - 255）
• fibaro_control_rgb_light：對 RGB 燈進行全面控制（開關 + 顏色 + 亮度）
• fibaro_run_scene：通過 ID 運行場景
• fibaro_stop_scene：通過 ID 停止場景

支持的 AI 客戶端

• Claude Desktop - 全面支持 MCP
• Cursor - 支持用於 AI 編程的 MCP 集成

🔧 技術細節

安全性

• 此服務器僅在本地連接到 Fibaro HC3
• 登錄憑證安全存儲在 MCP 配置中
• 支持 HTTP 和 HTTPS，並接受自簽名證書
• 日誌中不存儲敏感信息

故障排除

無法連接到 Fibaro HC3

• 重新運行安裝腳本：./install-claude.sh
• 檢查 IP 地址和端口（默認 HTTP: 80，HTTPS: 443）
• 確保用戶名/密碼正確
• 檢查防火牆和網絡連接
• 嘗試從瀏覽器訪問 HC3 網頁界面

MCP 服務器無法正常工作

• 檢查 Claude 配置中的路徑
• 確保項目已構建（npm run build）
• 配置更改後重啟 Claude Desktop
• 檢查 Claude Desktop 日誌以獲取詳細錯誤信息

更改 Fibaro HC3 連接信息

若要更改 IP、用戶名或密碼，請按以下步驟操作：

1. 重新運行安裝腳本：./install-claude.sh
2. 輸入新信息
3. 重啟 Claude Desktop

📄 許可證

本項目為演示/教育項目，不可用於商業用途。

⚠️ 重要提示

這是 Fibaro HC3 MCP 服務器的演示/教育版本。它並非商業產品，僅用於學習和測試目的。使用時請自行承擔風險。