MMCPMarkets
TH

timcinel/homekit-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

10 stars 8 forks 品質 49 トレンド 18MIT
Repository Install

ホームキットのMCP

概要

HomeKit 用の HTTP ベースのモデルコンテキストプロトコル (MCP) サーバー。 HomeKit のアクセサリと部屋のリストと管理するためのツールを提供します。 また、部屋全体でホームアシスタントアクセサリーを管理するためのスクリプトで、これのすべてのための実際のモチベーションです。 これは、CLI ツールではなく macOS アプリとして実装されています。HomeKit は、Xcode プロジェクトでしか達成できない、適切な資格を持つ署名されたバイナリが必要です。 - macOS 13.0+ と HomeKit のセットアップ - Xcode (コマンドラインツール付き) - Apple ID (開発に十分な無料のティア) - ホームアプリで設定された HomeKit アクセサリ サーバは[http://localhost:8080.から起動します。 HTTP サービスの直接に対してスクリプトを行なう場合は、スクリプト/homekitctl.py で軽量な Python CLI を使用します。 Python標準ライブラリのみを使用しているため、ノンmacOSマシンからHTTP経由でMacホストに到達できる限り実行できます。 CLI はデフォルトで http://localhost:8080 に話します.

概要（AI 翻訳）

HomeKit 用の HTTP ベースのモデルコンテキストプロトコル (MCP) サーバー。 HomeKit のアクセサリと部屋のリストと管理するためのツールを提供します。

HomeKit 用の CLI もあります。

また、部屋全体でホームアシスタントアクセサリーを管理するためのスクリプトで、これのすべてのための実際のモチベーションです。

これは、CLI ツールではなく macOS アプリとして実装されています。HomeKit は、Xcode プロジェクトでしか達成できない、適切な資格を持つ署名されたバイナリが必要です。

前提条件

  • macOS 13.0+とHomeKitのセットアップ
  • Xcode(コマンドラインツール付き)
  • アップルID(開発に十分な無料ティア)
  • ホームアプリで設定されたHomeKitアクセサリ

クイックスタート

サーバは[http://localhost:8080]を開始します。

クロード コードに追加:

利用可能なMCPツール

| ツール | 説明 | パラメーター | お問い合わせ | [get_all_accessories | 名、部屋、カテゴリ、UUIDsの全てのHomeKitアクセサリの一覧 | なし | | [get_all_rooms | 名と UUID の全ての HomeKit の客室一覧 | なし | | [set_accessory_room | UUIDs | [[accessory_uuid]の異なる部屋にアクセサリーを移動させる | | [get_accessory_by_name | 別府のホームキット・アクセサリーを探す | [[[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 のガイドから始めましょう →