🤝 ホームアシスタント MCP サーバー

Home Assistant と統合してスマート ホーム制御機能を提供するモデル コンテキスト プロトコル (MCP) サーバー プロジェクト。

プロンプト

サーバーは、各ドメインのツール セットのプロンプトを提供します。

ツール

サーバーは、Home Assistantの様々なドメインの制御を実装します。現在サポートしているのは以下です。

• 💡 ライト：オン/オフ、明るさ調節

• 🌡️ 気候: 温度制御、HVAC モード

• 🔒 ロック：ロック/ロック解除機能

• 🚨 警報制御パネル: セキュリティシステムの作動/解除

• 💧 加湿器：湿度コントロール

ツールの例には次のものがあります:

light-turn_on()
climate-turn_off()
alarm_control_panel-disarm()
lock-lock()
humidifier-turn_off()

構成

環境変数

ルート ディレクトリに次の.envファイルを作成します。

HOMEASSISTANT_TOKEN=your_long_lived_access_token_here # get it from your Home Assistant instance after onboarding
HOMEASSISTANT_BASE_URL=your_home_assistant_url_here # e.g. http://homeassistant.local:8123

Related MCP server: Hass-MCP

クイックスタート

インストール

Home Assistant をインストールして長期アクセス トークンを取得する方法についての指示に従ってください。

• ホームアシスタント入門

クロードデスクトップ

MacOS の場合: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

発達

建築と出版

配布用のパッケージを準備するには:

1. 依存関係を同期し、ロックファイルを更新します。

uv sync

2. パッケージディストリビューションをビルドします。

uv build

これにより、 dist/ディレクトリにソースとホイールのディストリビューションが作成されます。

3. PyPI に公開:

uv publish

注: 環境変数またはコマンド フラグを使用して PyPI 資格情報を設定する必要があります。

• トークン: --tokenまたはUV_PUBLISH_TOKEN

• またはユーザー名/パスワード: --username / UV_PUBLISH_USERNAMEおよび--password / UV_PUBLISH_PASSWORD

デバッグ

MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグ環境を実現するには、 MCP Inspectorの使用を強くお勧めします。

次のコマンドを使用して、 npm経由で MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory /Users/miguel/Documents/home-assistant-server/home-assistant-server run home-assistant-server

起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。

貢献

このプロジェクトへの貢献にご興味をお持ちいただきありがとうございます。

ガイドラインについてはCONTRIBUTING.mdをご覧ください。

ライセンス

MIT ライセンス - 詳細についてはライセンスを参照してください。