技术文档摘要

Hubitat MCP 服务器

将 Hubitat Maker API 设备 暴露给一个 MCP（模型上下文协议）服务器，这样像 Claude Desktop 这样的AI助手就可以控制您的智能家居。

它使用 Hubitat Maker API 访问设备，并与 mcp-proxy 项目集成。

---

功能

• 列出 Hubitat 设备及其属性
• 向设备发送开关和自定义命令
• 支持与 MCP 兼容的助手（如 Claude Desktop 等）
• 支持 本地 或 云端 Maker API URL

---

预备条件

1. 安装了 Maker API 应用 的 Hubitat Hub。
2. 您的 Maker API 应用ID 和 访问令牌。
3. 已安装 Python 3.10+。
4. 已安装 MCP Proxy —— mcp-proxy GitHub 仓库。

---

本地 vs 云端 URL

本地 URL（推荐用于速度）：

http://<HUBITAT_LOCAL_IP>/apps/api/<APP_ID>/devices

云端 URL（较慢，远程工作）：

https://cloud.hubitat.com/api/<CLOUD_ID>/apps/<APP_ID>/devices

---

安装

git clone https://github.com/abeardmore/hubitat-mcp.git
cd hubitat-mcp
pip install -r requirements.txt

---

配置

复制示例环境文件：

cp .env.example .env

编辑 .env 并设置：

HUBITAT_BASE_URL=http://192.168.1.50/apps/api/<APP_ID>/devices
HUBITAT_TOKEN=<YOUR_ACCESS_TOKEN>

---

运行服务器

python hubitat_mcp_server.py

---

Claude Desktop 集成

在您的 claude_desktop_config.json 文件中添加以下内容：

{
  "mcpServers": {
    "hubitat": {
      "command": "mcp-proxy",
      "args": ["http://localhost:5005"]
    }
  }
}

重启 Claude Desktop。您的 Hubitat 设备现在应该可以被发现并控制。

---

许可证

MIT

---

使用想法

一旦您的 MCP 服务器运行并且 Claude Desktop 已连接，您可以要求 Claude 执行操作或从您的 Hubitat 设置中检索信息。

控制设备

要求 Claude 开启/关闭设备或更改设置。

打开办公室角落灯。
将客厅灯光亮度设置为30%。
关闭办公室内所有灯光。

列出设备

获取所有可用设备列表。

列出我的 Hubitat 设备。

检查设备状态

询问当前状态或属性值。

客厅的温度是多少？
车库门是开还是关？
显示我所有传感器的电池电量。

获取见解

分析智能家居数据。

今天哪些灯光开启时间最长？
显示过去24小时内未响应的设备。
总结今天的运动传感器活动。

自动化及例行程序

设计例行程序和自动化。

创建一个早晨例行程序，开启厨房灯光，启动咖啡机，并将恒温器设置为72°F。
帮助我创建一个睡前例行程序，关闭所有灯光并锁上门。

💡 提示： Claude 可以将动作链接在一起，并帮助设计复杂的 Hubitat 或 MCP 自动化。

---