JinDaGe - fibaro-mcp-server MCP Details

article

README

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

fibaro-mcp-server