timcinel/homekit-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

10 stars 8 forks Качество 49 Тренд 18MIT

Repository Install

MCP для HomeKit

Обзор

HTTP-сервер Model Context Protocol (MCP) для HomeKit. Предоставляет инструменты для перечисления и управления аксессуарами и комнатами HomeKit. Кроме того, сценарий поможет управлять аксессуарами Home Assistant в разных комнатах, что является реальной мотивацией для всего этого. Это реализовано как приложение macOS, а не инструмент CLI, потому что HomeKit требует подписанного двоичного кода с надлежащими правами, которые могут быть достигнуты только через проект Xcode. - macOS 13.0+ с настройкой HomeKit - Xcode (с инструментами командной строки) - Apple ID (бесплатный уровень, достаточный для разработки) - аксессуары HomeKit, настроенные в приложении Home Сервер будет запущен на http://localhost:8080. Если вы предпочитаете писать против службы HTTP напрямую, используйте легкий Python CLI в скриптах /homekitctl.py. Он использует только стандартную библиотеку Python, поэтому он может работать с не-мако-машин, если они могут достичь хоста Mac по HTTP. Связь с [[Т1]] по умолчанию.

Обзор (машинный перевод)

HTTP-сервер Model Context Protocol (MCP) для HomeKit. Предоставляет инструменты для перечисления и управления аксессуарами и комнатами HomeKit.

Также CLI для HomeKit.

Кроме того, сценарий поможет управлять аксессуарами Home Assistant в разных комнатах, что является реальной мотивацией для всего этого.

Это реализовано как приложение macOS, а не инструмент CLI, потому что HomeKit требует подписанного двоичного кода с надлежащими правами, которые могут быть достигнуты только через проект Xcode.

Предпосылки

macOS 13.0+ с поддержкой HomeKit Xcode (с инструментами командной строки) Apple ID (свободный уровень, достаточный для разработки)

аксессуары HomeKit, настроенные в приложении Home

Быстрый старт

Сервер будет запущен http://localhost:8080.

Добавить в Claude Code:

Доступные инструменты MCP

| Инструмент | Описание | Параметры |

T1 Перечислите все аксессуары HomeKit с именами, комнатами, категориями и UUID. get_all_rooms Перечислите все комнаты HomeKit с именами и UUID. [[Т3]] Переместите аксессуар в другую комнату с помощью UUID [[Т4]], [[Т5]] get_accessory_by_name | Найти аксессуар HomeKit по имени | name

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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`