Home MCP Bridge

MCPAI代理

提供方 coalsi

AI代理 未标注 无需鉴权 社区 / 第三方 Claude DesktopClaude

HomeMCPBridge是一款macOS应用,通过Model Context Protocol (MCP)实现AI助手与HomeKit设备的直接控制,支持灯光、开关、插座、风扇、门锁等多种设备类型。

一句话选型结论

按资料字段整理

Home MCP Bridge 属于AI代理类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 15 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量15暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Swift本地部署智能家居HomeKit集成AI控制MCP协议设备管理

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 15 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 15 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Home MCP Bridge当前 15 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方coalsi上游标注的维护方 coalsi
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.8 KB
来自项目仓库与上游目录的原文,未做删改

主页MCPBridge

通过模型上下文协议(MCP)为AI助手集成本地macOS HomeKit。

用自然语言控制整个智能家居 -没有Homebridge,没有家庭助理,没有云服务。只需直接访问HomeKit即可。

这是什么?

HomeMCPBridge是一款macOS应用程序,可让AI助手(Claude和其他支持MCP的人)直接控制您的HomeKit设备。让你的人工智能“关闭客厅的灯”或“将卧室设置为50%的亮度”,它就会工作。

特性

  • 本地HomeKit -直接访问苹果的HomeKit框架,无需桥接或黑客攻击
  • MCP协议 -适用于Claude Code、Claude Desktop和任何兼容MCP的AI
  • 所有设备类型 -灯、开关、插座、风扇、锁、车库门、恒温器
  • 完全控制 -开/关、亮度、颜色(色调/饱和度)、锁定/解锁、打开/关闭
  • 菜单栏应用程序 -在后台安静运行,并显示状态窗口
  • 插件系统 -使用Govee、加密NVR等进行扩展
  • 设备链接 -将HomeKit设备与插件对应设备链接以避免重复
  • MCPPost -向您的AI系统广播实时传感器事件
  • 相机快照 -从HomeKit和Scrypted相机捕获图像
  • 运动事件 -监控运动传感器、门铃和接触传感器

需求

  • macOS 14.0(索诺玛)或更高版本
  • 在Apple Home应用程序中配置的支持HomeKit的设备
  • MCP兼容的人工智能助手(Claude Code、Claude Desktop等)

安装

选项1:下载版本

下载最新 .dmg 从 发布 页面。

选项2:从源代码构建

  1. 克隆此仓库:```bash
    git clone https://github.com/coalsi/HomeMCPBridge.git
    cd HomeMCPBridge

1. 在Xcode中打开:```bash
open HomeMCPBridge.xcodeproj
  1. 在签名和能力中选择您的开发团队

  2. 构建并运行(Cmd+R)-选择“我的Mac(Mac Catalyst)”

  3. 出现提示时授予HomeKit访问权限

配置

将以下内容添加到MCP配置文件中:

克劳德代码 (.mcp.json 在您的项目或 ~/.claude/mcp.json):```json
{
"mcpServers": {
"homekit": {
"command": "/Applications/HomeMCPBridge.app/Contents/MacOS/HomeMCPBridge",
"args": []
}
}
}


**适用于克劳德桌面** (`~/Library/Application Support/Claude/claude_desktop_config.json`):```json
{
"mcpServers": {
"homekit": {
"command": "/Applications/HomeMCPBridge.app/Contents/MacOS/HomeMCPBridge",
"args": []
}
}
}

用法

配置后,您可以问您的AI以下问题:

  • “列出我的所有HomeKit设备”
  • “打开厨房的灯”
  • “将客厅灯设置为50%亮度”
  • “车库里的温度是多少?”
  • “把后院的灯都关掉”
  • “锁上前门”
  • “车库门开着吗?”
  • “从前门摄像头拍摄快照”
  • “后院有动静吗?”

可用的MCP工具

设备控制

工具 说明
list_devices 列出HomeKit和插件中的所有设备
list_rooms 列出所有家庭的所有房间
list_homes 列出所有已配置的HomeKit家庭
get_device_state 获取设备的当前状态
control_device 控制设备(打开、关闭、切换、亮度、颜色、锁定、解锁、打开、关闭)

相机

工具 说明
list_cameras 列出所有HomeKit摄像头
capture_snapshot 从相机捕获图像(返回base64)

运动与活动

工具 说明
list_motion_sensors 列出运动传感器、占用传感器、门铃
get_motion_state 获取当前运动检测状态
subscribe_events 启用运动和接触事件缓冲
get_pending_events 轮询缓冲动作/门铃/接触事件

加密NVR(需要配置)

工具 说明
scrypted_list_cameras 列出所有具有功能的加密摄像头
scrypted_capture_snapshot 从加密相机拍摄快照
scrypted_get_camera_state 获取包括运动检测在内的相机状态
scrypted_set_webhook_token 为摄像头配置webhook令牌

支持的设备类型

  • 光 -开/关、亮度、颜色(色调/饱和度)
  • 开关 -开/关
  • 奥特莱斯 -开/关
  • 粉丝 -开/关
  • 锁 -锁定/解锁
  • 车库门 -打开/关闭
  • 恒温器 -读取温度(控制即将到来)
  • 传感器 -读取值
  • 相机 -捕获快照
  • 运动传感器 -检测运动/占用情况
  • 接触传感器 -门窗打开/关闭

应用程序标签

状态

智能家居设置概述:

  • Apple HomeKit设备数量
  • 插件状态和设备计数
  • 设备链接计数
  • 应用程序设置(菜单栏、dock图标)

设备

浏览按房间组织的所有设备:

  • 点击(i)链接/取消链接设备
  • 显示设备来源(HomeKit、Govee等)
  • 表示链接的设备

插件

配置第三方集成:

  • Govee-智能灯具和电器
  • 加密NVR-网络摄像机

MCPPost

向您的AI广播实时传感器事件:

  • 配置webhook端点URL
  • 启用/禁用事件广播
  • 查看最近的事件及其状态
  • 测试端点连接

设置

完整的设置指南,包括:

  • MCP配置片段
  • 插件设置说明(Govee、Scrypted)
  • MCPPost配置
  • 设备链接指南

日志

调试的完整活动日志:

  • 所有MCP工具调用
  • 插件活动
  • 事件通知
  • 清除和滚动控件

设备链接

当你在HomeKit和插件(如Govee)中都有相同的设备时,你可以将它们链接起来,这样它们就被视为一个设备:

  1. 去 设备 标签
  2. 点击 (i) 任何设备上的按钮
  3. 选择 “链接设备…”
  4. 从其他来源选择相应的设备

链接的设备会自动使用功能最强大的源代码(插件通常比HomeKit具有更多功能)。


MCPPost(活动广播)

MCPPost将实时传感器事件广播到自定义HTTP端点,使您的AI系统(如Jarvis)能够接收推送通知。

配置

  1. 开放式家庭MCPBridge
  2. 去 MCPPost 标签
  3. 输入您的端点URL(例如。, http://localhost:8000/api/events)
  4. 通过切换启用广播
  5. 点击“测试端点”进行验证

支持的活动

  • 运动传感器 -检测到/清除运动
  • 占用传感器 -房间入住率变化
  • 门铃 -戒指事件
  • 接触传感器 -门窗打开/关闭

事件负载```json

{
"event_id": "uuid",
"event_type": "motion|occupancy|doorbell|contact",
"source": "HomeKit",
"timestamp": "2024-01-18T21:00:00Z",
"sensor": {
"name": "Front Door Motion",
"id": "sensor-uuid",
"room": "Hallway",
"home": "Home"
},
"data": {
"detected": true,
"state": "open",
"isOpen": true
}
}


______________________________________________________________________

## 插件系统

### 内置插件

|插件|身份验证|描述|
|--------|----------------|-------------|
| **苹果HomeKit** |本机(始终启用)|直接访问HomeKit设备|
| **州长** |API密钥|控制Govee智能灯和电器|
| **加密NVR** |用户名/密码|访问加密摄像头和运动检测|

### 政府设置

1. 在手机上打开Govee Home应用程序
1. 首选 **设置>关于我们>申请API密钥**
1. 等待批准(通常在几天内)
1. 从电子邮件中复制您的API密钥
1. 在HomeMCPBridge中,转到 **插件>Govee** 并输入您的API密钥
1. 启用Govee插件

### 加密NVR设置

1. 在您的网络上安装并配置Scrypted
1. 注意你的加密服务器URL(例如。, `https://mac-mini.local:10443`)
1. 安装 `@scrypted/webhook` Scrypted中的插件
1. 为每个摄像头创建一个摄像头webhook并记下令牌
1. 在HomeMCPBridge中,转到 **插件>加密** 并输入凭据
1. 使用 `scrypted_set_webhook_token` 配置每个相机令牌的工具

______________________________________________________________________

## 插件开发指南

想添加对另一个智能家居平台的支持吗?以下是如何创建自定义插件。

### 插件协议```swift
protocol DevicePlugin: AnyObject {
var identifier: String { get }
var displayName: String { get }
var isEnabled: Bool { get set }
var isConfigured: Bool { get }
var configurationFields: [PluginConfigField] { get }

func initialize() async throws
func shutdown() async
func listDevices() async throws -> [UnifiedDevice]
func getDeviceState(deviceId: String) async throws -> [String: Any]
func controlDevice(deviceId: String, action: String, value: Any?) async throws -> ControlResult
func configure(with credentials: [String: String]) async throws
func clearCredentials()
}

注册您的插件```swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions...) {
PluginManager.shared.register(MyPlatformPlugin())
}
```


隐私

主页MCPBridge:

  • 完全在Mac上运行
  • 通过Apple的框架直接与HomeKit设备通信
  • 不向外部服务器发送任何数据(您配置的MCPPost除外)
  • 本地设备控制不需要互联网连接

故障排除

“未找到设备”

  • 确保您在Apple Home应用程序中设置了设备
  • 在应用程序首次启动时授予HomeKit权限
  • 尝试重新启动应用程序

“无法访问设备”

  • 检查设备是否已通电并连接到您的网络
  • 验证它在Apple Home应用程序中显示为可访问

MCP未连接

  • 确保应用程序正在运行(检查菜单栏)
  • 验证MCP配置中的路径是否与安装应用程序的位置匹配
  • 更改配置后重新启动AI助手

加密快照不起作用

  • 确保已安装@scrypted/webhook插件
  • 为Scrypted中的每个摄像头创建摄像头webhook
  • 使用 scrypted_set_webhook_token 配置令牌

贡献

欢迎投稿!请随时打开问题或提交PR。

许可证

MIT许可证-请参阅 许可证 了解详情。

致谢

  • 基于苹果的HomeKit框架构建
  • 使用 模型上下文协议 通过Anthropic

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Home MCP Bridge 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Home MCP Bridge 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Home MCP Bridge 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Home MCP Bridge 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Home MCP Bridge 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Home MCP Bridge 能提供哪些能力?

资料显示约 15 个工具;能力标签包括 Swift、设备管理、智能家居、Claude、AI控制。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。