Homekit MCP
让 AI Agent 直接控制 Apple Home——通过 MCP 协议，Claude/Cursor/Codex 可以开关灯、锁门、读传感器，单接口控制所有 HomeKit 设备
这是什么
Homekit MCP 让 AI Agent 直接控制你的 Apple Home 智能家居——通过 MCP 协议，Claude、Cursor、Codex 可以开关灯、锁门、读取传感器数据，一个接口控制所有 HomeKit 设备。
适合人群：Apple HomeKit 用户、智能家居爱好者、想用 AI Agent 自动化家居场景的技术用户。前提是拥有 macOS 设备 + HomeKit 配置。
快速上手
1. 准备工作
- macOS 设备（HomeKit 需要 Apple 生态）
- 已配置的 HomeKit 设备（灯、门锁、传感器等）
- Node.js 18+
2. 安装
git clone https://github.com/bolivestilo/Homekit.git
cd Homekit
npm install
3. 配置 MCP
在 Claude Code / Cursor 的 MCP 配置中添加：
{
"mcpServers": {
"homekit": {
"command": "node",
"args": ["/path/to/Homekit/index.js"]
}
}
}
4. 使用
配置完成后，你的 AI Agent 就可以：
- 「帮我把客厅的灯关掉」
- 「查看卧室的温度」
- 「锁上大门」
- 「检查所有传感器状态」
核心功能
- 灯光控制：AI Agent 语音/文本控制开关灯
- 门锁控制：远程控制 HomeKit 门锁
- 传感器读取：温度/湿度/运动传感器数据
- 单接口统一：所有 HomeKit 设备通过 MCP 协议统一访问
- Claude/Cursor/Codex 兼容
常见踩坑
-
macOS 限制：HomeKit MCP 仅支持 macOS，Windows/Linux 用户无法使用。
-
HomeKit 权限：首次运行需要授予终端 HomeKit 访问权限。系统偏好设置 → 隐私与安全性 → HomeKit。
-
设备发现延迟：HomeKit 设备发现需要 5-10 秒，首次启动稍慢。
-
网络要求：设备和 Mac 必须在同一局域网。远程控制需要 Home Hub（Apple TV/HomePod）。
-
安全性：MCP 接口暴露了所有 HomeKit 设备控制权，确保只有信任的 AI Agent 可以访问。
常见问题 FAQ
Q1: 和 Apple Home App 有什么区别？
A: Home App 是手动操作界面。Homekit MCP 让 AI Agent 可编程控制——你可以用自然语言让 AI Agent 执行复杂的自动化场景。
Q2: 支持哪些设备？
A: 所有支持 Apple HomeKit 协议的设备：灯（Philips Hue、Nanoleaf）、门锁（August、Yale）、传感器（Eve、Aqara）、恒温器（ecobee）等。
Q3: 需要 Home Hub 吗？
A: 局域网内控制不需要。远程控制（离开家时）需要 Apple TV 或 HomePod 作为 Home Hub。
Q4: 可以和 Homebridge 一起用吗？
A: 可以。Homebridge 把非 HomeKit 设备桥接到 HomeKit，然后 Homekit MCP 可以控制它们。
Q5: 安全吗？
A: 数据完全本地运行，不经过第三方服务器。但 MCP 接口暴露了所有智能家居控制权，建议仅在内网信任环境中使用。
参考链接
📊 评分与标签
评分说明
总分 8.2/10 · P_优选
📊 可观测社区指标（数据核验日期：2026-07-09）
- GitHub: bolivestilo/Homekit ★66, 🔱1
- 语言: TypeScript
- 创建: 2026-07-08 | 最近更新: 2026-07-08
- 许可证: MIT
- Topics: apple-home, claude, homekit, iot, mcp, smart-home
- 趋势: 58⭐ today (trendshift.io)
- 来源: GitHub
⚙️ 功能完整度 2.0/2.5
- 灯光控制——AI Agent 语音/文本控制开关灯
- 来源：GitHub
- 门锁控制——远程控制 HomeKit 门锁
- 传感器读取——温度/湿度/运动传感器数据
- 单接口统一——所有 HomeKit 设备通过 MCP 协议统一访问
- Claude / Cursor / Codex 兼容——主流 AI Agent 均可使用
- 竞品对比 Homebridge：Homekit MCP AI 原生控制 vs Homebridge 设备兼容桥接
- 竞品对比 Apple Home App：Homekit MCP Agent 可编程 vs Home App 手动操作
- 竞品对比 Home Assistant：Homekit MCP 轻量 MCP 专注 vs HA 全功能平台
✨ 输出质量 1.8/2.5
- 依赖 HomeKit 协议稳定性——Apple 官方协议保障
- TypeScript 实现，代码质量可维护
- 竞品对比 Homebridge：Homebridge 成熟稳定多年 vs Homekit MCP 新项目
- 竞品对比 Home Assistant：HA 功能更全面 vs Homekit MCP 专注 MCP 集成
🖐️ 易用性 1.0/1.5
- 需 macOS + HomeKit 配置——仅限 Apple 生态
- 来源：GitHub
- MCP 协议——Claude/Cursor/Codex 配置后即可使用
- 竞品对比 Apple Home App：零配置打开即用 vs Homekit MCP 需技术配置
- 竞品对比 Homebridge：类似配置复杂度
💰 性价比 1.5/1.5
- MIT 开源免费
- 来源：GitHub
- 无额外硬件需求——使用现有 HomeKit 设备
- 竞品对比 Home Assistant：免费开源 vs Homekit MCP 同样免费
- 竞品对比 Apple Home App：免费预装 vs Homekit MCP 同样免费
🔒 稳定性 0.5/1.0
- 2026-07-08 创建，仅 1 天项目
- 66 Stars 首日增长迅速
- 竞品对比 Homebridge：多年稳定运行 vs Homekit MCP 1 天项目
- 竞品对比 Home Assistant：成熟开源社区 vs Homekit MCP 新项目
🛡️ 隐私安全 1.0/1.0
- 本地运行——数据不出设备，智能家居数据完全隐私
- 竞品对比 Apple Home App：Apple 云端同步 vs Homekit MCP 本地运行
- 竞品对比 Home Assistant：同样本地运行，安全级别相当
🏷️ 标签说明
- 开源免费: MIT 许可证。来源: GitHub
- MCP: MCP 协议，AI Agent 控制智能家居。来源: GitHub
- 物联网: 智能家居，Apple HomeKit 集成。来源: GitHub
- 海外: 开源项目。来源: GitHub
📋 来源与核验记录
- ✅ web_search 已验证: GitHub — 确认 66 Stars, MIT, TypeScript
- ✅ web_search 已验证: trendshift.io — 确认 58⭐ today 趋势
- ⚠️ 未验证（新项目）: HomeKit 设备兼容性 — 仅 1 天项目，需验证设备兼容范围
同分类推荐
AI编程 分类下的其他工具