AI导哈

智能家居控制服务器

Fibaro HC3 MCP Server是一个通过Claude AI控制Fibaro Home Center 3的模型上下文协议服务器，提供设备控制、场景管理等功能。

  • by kaeljune
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 kaeljune/fibaro-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. 重新启动克劳德桌面

许可证

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

相关 MCP