timcinel/homekit-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

10 stars 8 forks 품질 49 트렌드 18MIT

Repository Install

HomeKit를 위한 MCP

개요

HTTP 기반 모델 Context Protocol (MCP) Server for HomeKit. HomeKit 액세서리 및 객실 목록 및 관리 도구 제공. 또한 각 객실마다 홈 어시스트 액세서리를 관리하는 데 도움이되는 스크립트도, 이 모든 것이 실제 동기입니다. HomeKit가 Xcode 프로젝트를 통해만 달성할 수 있는 적절한 entitlements를 가진 서명된 바이너리를 필요로 하는 CLI 도구 보다는 오히려 macOS 앱으로 구현됩니다. - macOS 13.0+ with HomeKit setup - Xcode ( 명령줄 도구 포함) - Apple ID (개발에 충분하지 않은 계층) - HomeKit 액세서리로 구성된 홈 앱 서버가 http://localhost:8080.에서 시작합니다. HTTP 서비스에 대한 스크립트를 직접 한다면, 스크립트/homekitctl.py의 라이트 파이썬 CLI를 사용합니다. 그것은 단지 파이썬 표준 라이브러리를 사용합니다, 그래서 그들은 HTTP를 통해 Mac 호스트에 도달 할 수있는만큼 non-macOS 기계에서 실행할 수 있습니다. CLI는 기본적으로 http://localhost:8080 로 대화합니다.

개요(AI 번역)

HTTP 기반 모델 Context Protocol (MCP) Server for HomeKit. HomeKit 액세서리 및 객실 목록 및 관리 도구 제공.

HomeKit에 대한 CLI도 있습니다.

또한 각 객실마다 홈 어시스트 액세서리를 관리하는 데 도움이되는 스크립트도, 이 모든 것이 실제 동기입니다.

HomeKit가 Xcode 프로젝트를 통해만 달성할 수 있는 적절한 entitlements를 가진 서명된 바이너리를 필요로 하는 CLI 도구 보다는 오히려 macOS 앱으로 구현됩니다.

필수품

macOS 13.0+ 와 HomeKit 설정
Xcode ( 명령줄 도구와 함께)
Apple ID (개발에 충분하지 않음)
HomeKit 액세서리는 홈 앱에서 구성

빠른 시작

서버는 http://localhost:8080에서 시작합니다.

Claude 코드에 추가:

사용 가능한 MCP 도구

도구	묘사	모수
`get_all_accessories`	이름, 객실, 카테고리, UUID로 모든 홈키트 액세서리	없음
`get_all_rooms`	이름과 UUID가 있는 모든 홈키트 룸	없음
`set_accessory_room`	UUIDs를 사용한 다른 방에 액세서리를 이동	[T4], `room_uuid`
[T6]	이름의 홈킷 액세서리 찾기	[T7]

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

HomeKit MCP … and CLI … and Room Plan/Apply script

HTTP-based Model Context Protocol (MCP) server for HomeKit. Provides tools to list and manage HomeKit accessories and rooms.

Also a CLI for HomeKit.

Also a script to help manage Home Assistant accessories across rooms, which is the actual motivation for all of this.

This is implemented as a macOS app rather than a CLI tool because HomeKit requires a signed binary with proper entitlements that can only be achieved through an Xcode project.

Prerequisites

macOS 13.0+ with HomeKit setup
Xcode (with Command Line Tools)
Apple ID (free tier sufficient for development)
HomeKit accessories configured in the Home app

Quick Start

git clone https://github.com/TimCinel/HomeKitSync.git
cd HomeKitSync
make build
make run

The server will start on http://localhost:8080.

Add to Claude Code:

claude mcp add --transport http homekit http://localhost:8080/mcp

Available MCP Tools

Tool	Description	Parameters
`get_all_accessories`	List all HomeKit accessories with names, rooms, categories, and UUIDs	None
`get_all_rooms`	List all HomeKit rooms with names and UUIDs	None
`set_accessory_room`	Move an accessory to a different room using UUIDs	`accessory_uuid`, `room_uuid`
`get_accessory_by_name`	Find a HomeKit accessory by name	`name`
`get_room_by_name`	Find a HomeKit room by name	`name`
`set_accessory_room_by_name`	Move an accessory to a different room using names	`accessory_name`, `room_name`
`rename_accessory`	Rename a HomeKit accessory	`accessory_name`, `new_name`
`rename_room`	Rename a HomeKit room	`room_name`, `new_name`
`get_room_accessories`	Get all accessories in a specific room	`room_name`
`accessory_on`	Turn on an accessory (lights, switches) or open covers	`accessory_name`
`accessory_off`	Turn off an accessory (lights, switches) or close covers	`accessory_name`
`accessory_toggle`	Toggle an accessory between on/off or open/close	`accessory_name`

Available CLI Tools

CLI Wrapper

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →