HomeMCPBridge의 개요
HomeMCPBridge는 GitHub 사용자 coalsi(Corey Silvia)가 만든 것으로, Mac Catalyst로 만든 macOS 메뉴 막대 앱입니다. Apple의 HomeKit 프레임워크와 직접 통신하므로 MCP 클라이언트가 Homebridge 나 Home Assistant 없이 집, 방, 기기를 나열하고 상태를 읽고 제어할 수 있습니다. 제어 범위는 조명의 켜기, 끄기, 전환, 밝기와 색, 도어락 잠금과 해제, 차고 문 열기와 닫기이며, 온도 조절기는 당분간 읽기만 됩니다. HomeKit 카메라 스냅숏 촬영, 동작·초인종·문 열림 센서 이벤트 버퍼링, 지정한 웹훅으로 보내기도 할 수 있습니다.
MCP 클라이언트가 앱 바이너리를 stdio 서버로 실행하면 15개 도구가 등록됩니다. 선택형 플러그인으로 API 키를 쓰는 Govee 조명과 사용자 이름과 비밀번호를 쓰는 Scrypted NVR 카메라를 추가할 수 있습니다. 프로젝트는 MIT 라이선스의 Swift이고 GitHub 스타는 약 7개이며, 코드 거의 전부가 2026년 1월 18일과 19일에 작성되었고 이후로는 2026년 10월 15일의 README 변경 한 번뿐입니다.
HomeMCPBridge 설치 방법
git clone https://github.com/coalsi/HomeMCPBridge.git && open HomeMCPBridge/HomeMCPBridge.xcodeprojHomeMCPBridge, 쓸 만한 가치가 있습니까?
HomeKit 자체를 거치는 것은 올바른 구조입니다. Home Assistant의 MCP 서버는 훨씬 많은 일을 하지만 Home Assistant 설치가 필요하고, Homebridge 방식의 브리지는 항상 켜 둬야 하는 서비스를 하나 더 늘립니다. HomeMCPBridge는 Apple 홈 앱에 이미 설정된 집을 읽고 같은 Mac에서 Apple 프레임워크로 작동하며, README에 따르면 선택형 웹훅, Govee 클라우드 API, 사용자의 Scrypted 서버 외에는 아무것도 기기 밖으로 나가지 않습니다.
문제는 에이전트가 그 접근 권한으로 무엇을 할 수 있느냐입니다. control_device라는 도구 하나가 기기 이름과 동작을 받는데, 그 동작에는 도어락을 여는 것과 차고 문을 여는 것이 들어 있습니다. 저희가 소스를 읽은 바로는 확인 단계도, 허용 목록도, 잠금장치를 읽기 전용으로 만드는 방법도 없습니다. 호출은 곧바로 HomeKit으로 갑니다. 카메라 스냅숏은 base64 JPEG 이미지로 돌아오므로 집 안의 장면이 모델 제공업체로 갑니다.
작은 보안상의 지름길도 있습니다. Scrypted 플러그인은 접속하는 서버의 TLS 인증서를 무엇이든 받아들입니다. 자체 서명 인증서를 쓰는 가정용 NVR에는 편하지만 같은 네트워크의 사칭 서버도 받아들입니다. MCPPost는 동작과 초인종 이벤트를 암호화되지 않은 HTTP를 포함해 입력한 어떤 URL로든 보냅니다.
더 큰 장애물은 빌드입니다. README는 Releases 페이지의 .dmg를 안내하지만 릴리스가 없으므로, 설치하려면 Xcode에서 프로젝트를 열고 자신의 서명 팀을 고른 뒤 Mac Catalyst용으로 빌드해야 합니다. 유일한 열린 이슈는 2026년 1월 27일에 등록된 것으로, HomeKit 사용 목적 설명이 없어 MCP 도구를 호출하면 앱이 충돌한다고 보고합니다. 키는 이제 Info.plist에 들어 있지만 이슈에는 답이 없습니다. 6,628줄 거의 전부가 main.swift 파일 하나에 들어 있습니다.
제 역할을 하는 곳
Mac mini를 집의 HomeKit 허브로 쓰는 개발자
터미널 에이전트로 방 조명을 켜고 끄고 센서를 확인하고 싶다
앱을 빌드하고 바이너리 경로를 Claude Code의 MCP 설정에 추가한 뒤 '거실 램프 50%로'나 '차고 문 열려 있어?'라고 요청합니다. 무료입니다. 잠금장치와 차고 문을 제외하려면 보이는 집에서 이름을 바꾸거나 빼십시오.
이미 카메라에 Scrypted를 쓰는 주택 소유자
초인종이 울리면 이미지를 받아 에이전트에게 설명하게 하고 싶다
Scrypted 플러그인과 MCPPost를 켜고 get_pending_events를 확인한 뒤 capture_snapshot을 호출합니다. 이미지는 모두 모델 제공업체로 가므로, 포함된 Ollama 스크립트로 로컬 모델을 쓰는 방법과 비교해 판단하십시오.
도입 전 확인할 점
- 설정
- 저장소를 클론하고 HomeMCPBridge.xcodeproj를 열어 서명 팀을 고른 뒤 My Mac(Mac Catalyst)용으로 빌드하고, HomeKit 접근을 허용한 다음 MCP 클라이언트를 /Applications/HomeMCPBridge.app/Contents/MacOS/HomeMCPBridge로 지정합니다. macOS 14 이상이 필요합니다.
- 연동
- 기기, 카메라, 동작 이벤트, Scrypted용 도구 15개. Govee(API 키)와 Scrypted NVR(사용자 이름과 비밀번호) 플러그인. MCPPost 웹훅. 로컬 모델용 ollama_bridge.py 스크립트.
- 데이터와 개인정보
- Mac에서 stdio로 실행되며 대기 포트가 없습니다. 기기 상태 와 카메라 스냅숏은 모델 제공업체로 갑니다. 플러그인 자격 증명은 키체인에 저장됩니다. Scrypted 연결은 TLS 인증서 검증을 건너뜁니다.
- 제한
- 온도 조절기 제어 미구현. 릴리스 없음. 열린 충돌 보고 1건. 제어 동작은 15초 후 시간 초과. 기기를 이름으로 고르므로 홈 앱의 이름이 겹치지 않아야 합니다.
좋은 점
- 허브나 브리지 서버 없이 HomeKit에 직접 접근
- 홈 앱에 이미 설정된 내용을 그대로 읽음
- 카메라 스냅숏과 동작·초인종·문 열림 이벤트
- stdio로 로컬 실행. 열린 포트 없음
아쉬운 점
- 확인 단계 없이 잠금장치와 차고 문 제어
- 공개 릴리스 없음. Xcode에서 직접 빌드
- 충돌 보고가 답 없이 열려 있음
- Scrypted 플러그인이 모든 TLS 인증서를 받아들임
추천 대상
Xcode에 익숙한 Mac 사용자로서, 에이전트에게 HomeKit 조명, 플러그, 센서를 맡기되 잠금장치와 차고 문은 손이 닿지 않게 둘 사람에게 맞습니다.
HomeMCPBridge 대안
HomeMCPBridge: 자주 묻는 질문
- HomeMCPBridge, 쓸 만한 가치가 있습니 까?
- 별도 허브 없이 HomeKit을 에이전트에 바로 잇는 깔끔한 발상이지만, 미완성 빌드와 모델의 말 한마디에 현관문을 여는 control_device 도구가 발목을 잡습니다. 평점은 5점 만점에 2.8점입니다.
- HomeMCPBridge의 가격은 얼마입니까?
- 무료 오픈소스(MIT)입니다. Xcode에서 직접 빌드하며 공개 릴리스는 없습니다.
- HomeMCPBridge의 단점은 무엇입니까?
- 확인 단계 없이 잠금장치와 차고 문 제어; 공개 릴리스 없음. Xcode에서 직접 빌드; 충돌 보고가 답 없이 열려 있음; Scrypted 플러그인이 모든 TLS 인증서를 받아들임.
- HomeMCPBridge에 적합한 사람은 누구입니까?
- Xcode에 익숙한 Mac 사용자로서, 에이전트에게 HomeKit 조명, 플러그, 센서를 맡기되 잠금장치와 차고 문은 손이 닿지 않게 둘 사람에게 맞습니다.
- HomeMCPBridge에 회사 데이터를 맡겨도 안전합니까?
- Mac에서 stdio로 실행되며 대기 포트가 없습니다. 기기 상태와 카메라 스냅숏은 모델 제공업체로 갑니다. 플러그인 자격 증명은 키체인에 저장됩니다. Scrypted 연결은 TLS 인증서 검증을 건너뜁니다.
- HomeMCPBridge의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Home Assistant MCP Server 및 Aqara MCP Server입니다.
답변 확인일: 2026년 11월 13일.