🚀 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 客户端
- ✅ 安装完成，即可使用！
📋 手动安装
如果您倾向于手动安装，请按以下步骤操作：
- 克隆此仓库：
git clone https://github.com/kaeljune/fibaro-mcp-server.git
cd fibaro-mcp-server
- 安装依赖项：
npm install
- 构建项目：
npm run build
- 运行配置脚本：
./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 将自动完成以下操作：
- 连接到 Fibaro HC3（若尚未连接）
- 查找匹配的设备/场景
- 执行控制命令
- 报告结果
📚 详细文档
可用命令
信息类
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、用户名或密码，请按以下步骤操作：
- 重新运行安装脚本：
./install-claude.sh - 输入新信息
- 重启 Claude Desktop
📄 许可证
本项目为演示/教育项目，不可用于商业用途。
⚠️ 重要提示
这是 Fibaro HC3 MCP 服务器的演示/教育版本。它并非商业产品，仅用于学习和测试目的。使用时请自行承担风险。