Fibaro HC3 MCP Server

Fibaro HC3 MCP服务器

⚠️ 演示版本免责声明\ 这是一个 演示/教育版 Fibaro HC3 MCP服务器。它是 不是商业产品 并且仅按原样提供用于学习和测试目的。使用风险自负。

用于通过Claude AI控制Fibaro家庭中心3的MCP（模型上下文协议）服务器。

特性

• 自动连接 启动时连接到Fibaro HC3（一次性配置）
• 检索有关设备、场景和房间的信息
• 控制设备（打开/关闭、设置值、亮度、颜色）
• 奔跑和停止场景
• 完全集成Claude AI进行自然语言控制
• 支持具有颜色名称映射的RGB灯光
• HTTP/HTTPS协议支持

安装

🚀 快速安装（推荐）

一个命令安装 -无需克隆存储库：

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

此脚本将：

• ✅ 检查依赖关系（git、node.js、npm）
• ✅ 选择您的AI客户端（克劳德桌面或光标）
• ✅ 自动克隆存储库
• ✅ 询问Fibaro HC3连接详细信息
• ✅ 测试连接
• ✅ 安装依赖项并构建项目
• ✅ 自动配置您的AI客户端
• ✅ 准备使用！

📋 手动安装

如果您更喜欢手动安装：

1. 克隆此存储库：

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

1. 安装依赖项：

npm install

1. 构建项目：

npm run build

1. 运行配置脚本：

./install-claude.sh

用法

安装后， 无需手动连接。当您的AI客户端（Claude Desktop或Cursor）启动时，MCP服务器将自动连接到Fibaro HC3。

支持的AI客户端

• 克劳德桌面 -完全支持MCP
• 光标 -用于AI驱动编码的MCP集成

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"

可用命令

信息

• 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停止场景

集成示例

配置后，您可以像这样与Claude交谈：

• “把屋里的灯都关掉”
• “打开卧室灯”
• “跑早上好现场”
• “显示所有传感器的状态”
• “将客厅灯光亮度设置为50%”
• “将客厅RGB灯更改为绿色”
• “将RGB灯号5设置为浅紫色”

克劳德将自动：

1. 连接到Fibaro HC3（如果尚未连接）
2. 查找匹配的设备/场景
3. 执行控制命令
4. 报告结果

安全

• 此服务器仅本地连接到Fibaro HC3
• 登录凭据安全地存储在MCP配置中
• 支持HTTP和HTTPS，并接受自签名证书
• 日志中不存储敏感信息

故障排除

无法连接到Fibaro HC3

• 重新运行安装脚本： ./install-claude.sh
• 检查IP地址和端口（默认HTTP:80，HTTPS:443）
• 确保用户名/密码正确
• 检查防火墙和网络连接
• 尝试从浏览器访问HC3 web界面

MCP服务器不工作

• 检查Claude配置中的路径
• 确保项目已建成(npm run build)
• 配置更改后重新启动Claude Desktop
• 检查Claude Desktop日志以获取详细的错误消息

更改Fibaro HC3连接信息

要更改IP、用户名或密码：

1. 重新运行安装脚本： ./install-claude.sh
2. 输入新信息
3. 重新启动克劳德桌面

许可证

这是一个演示/教育项目。不用于商业用途。