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 服务器的演示/教育版本。它并非商业产品，仅用于学习和测试目的。使用时请自行承担风险。