bolivestilo/Homekit - 仓库详情

AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

它是首个连接 Apple HomeKit 框架与 AI 智能体层的开放桥梁，使智能体无需依赖面向人类的点触式界面即可控制家庭设备。

适合谁使用

构建智能体系统的 AI 开发者
希望增强自动化能力的 Apple Home 用户
使用 MCP 兼容客户端（Claude、Cursor、Windsurf）的开发者
家庭自动化爱好者

典型使用场景

通过自然语言命令由智能体辅助控制家庭设备（例如“在会议前关掉厨房灯”）
使用 AI 智能体动态创建和激活场景
通过智能体自动化日常流程并触发已有的自动化
以编程方式管理多个 Apple Home 及其配件的状态

项目优势

兼容模型上下文协议，可配合多种主流 AI 客户端使用
提供八个结构化工具，用于列出、获取、设置配件、场景和自动化
同时提供命令行界面和 MCP 服务器，并支持 JSON 输出便于集成
采用 MIT 开源许可证，拥有持续集成和 CodeQL 安全分析

使用前须知

需要 macOS 13 Ventura 或更高版本，且该 Mac 上需要已配置好 Apple Home
首次设置需要 Homekit macOS App 进行授权
仅限 Apple Home 生态系统，不支持非 HomeKit 的智能家居设备

README 快速开始

the bridge between AI Agents & Reality.

Homekit gives any AI agent direct, physical control over Apple Home. Flip lights. Lock doors. Read sensors. Through a single open interface.

Awaken · Understand · Witness · Install · Begin · Website · Docs · Changelog

✦ Awaken

Apple Home is powerful. But it's locked.

Locked behind apps. Behind Siri. Behind tap-to-toggle UI designed for humans, not agents. Every AI model in 2025 can reason, plan, and act — but the moment you ask it to "turn off the kitchen lights before the meeting", it hits a wall.

Homekit tears that wall down.

It exposes your entire Apple Home — every light, lock, thermostat, sensor, scene, and automation — as structured tools that any AI agent can call. The Model Context Protocol becomes the language. Your home becomes the body.

This is the first open bridge between Apple's HomeKit framework and the agent layer.

✦ Understand

Architecture

┌─────────────────────────────────────────────────────────┐
│                    AI Agent Layer                        │
│         Claude · ChatGPT · Cursor · Windsurf            │
│              Any MCP-compatible client                   │
└────────────────────┬────────────────────────────────────┘
                     │  Model Context Protocol (MCP)
                     │  8 structured tools
                     ▼
┌─────────────────────────────────────────────────────────┐
│                  homekit-mcp server                      │
│           stdio transport · JSON-RPC 2.0                 │
└────────────────────┬────────────────────────────────────┘
                     │  Unix socket / IPC
                     ▼
┌─────────────────────────────────────────────────────────┐
│              Homekit macOS App                           │
│         Native HomeKit framework bridge                  │
│     Authorization · Accessory state · Scene control     │
└────────────────────┬────────────────────────────────────┘
                     │  Apple HomeKit Framework
                     ▼
┌─────────────────────────────────────────────────────────┐
│                   Apple Home                             │
│   Lights · Locks · Thermostats · Sensors · Cameras      │
│          Scenes · Automations · Multi-Home               │
└──────────────────────────────────────────

项目描述

Homekit gives any AI agent direct, physical control over Apple Home. Flip lights. Lock doors. Read sensors. Through a single open interface.

Homekit