hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Integrations
Provides tools for controlling various Home Assistant domains including lights (on/off, brightness), climate systems (temperature, HVAC modes), locks (lock/unlock), alarm control panels (arm/disarm), and humidifiers (humidity control).
🤝 ホームアシスタント MCP サーバー
Home Assistant と統合してスマート ホーム制御機能を提供するモデル コンテキスト プロトコル (MCP) サーバー プロジェクト。
プロンプト
サーバーは、各ドメインのツール セットのプロンプトを提供します。
ツール
サーバーは、Home Assistantの様々なドメインの制御を実装します。現在サポートしているのは以下です。
- 💡 ライト:オン/オフ、明るさ調節
- 🌡️ 気候: 温度制御、HVAC モード
- 🔒 ロック:ロック/ロック解除機能
- 🚨 警報制御パネル: セキュリティシステムの作動/解除
- 💧 加湿器:湿度コントロール
ツールの例には次のものがあります:
構成
環境変数
ルート ディレクトリに次の.env
ファイルを作成します。
クイックスタート
インストール
Home Assistant をインストールして長期アクセス トークンを取得する方法についての指示に従ってください。
クロードデスクトップ
MacOS の場合: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows の場合: %APPDATA%/Claude/claude_desktop_config.json
発達
建築と出版
配布用のパッケージを準備するには:
- 依存関係を同期し、ロックファイルを更新します。
- パッケージディストリビューションをビルドします。
これにより、 dist/
ディレクトリにソースとホイールのディストリビューションが作成されます。
- PyPI に公開:
注: 環境変数またはコマンド フラグを使用して PyPI 資格情報を設定する必要があります。
- トークン:
--token
またはUV_PUBLISH_TOKEN
- またはユーザー名/パスワード:
--username
/UV_PUBLISH_USERNAME
および--password
/UV_PUBLISH_PASSWORD
デバッグ
MCPサーバーはstdio経由で実行されるため、デバッグが困難になる場合があります。最適なデバッグ環境を実現するには、 MCP Inspectorの使用を強くお勧めします。
次のコマンドを使用して、 npm
経由で MCP Inspector を起動できます。
起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。
貢献
このプロジェクトへの貢献にご興味をお持ちいただきありがとうございます。
ガイドラインについてはCONTRIBUTING.mdをご覧ください。
ライセンス
MIT ライセンス - 詳細についてはライセンスを参照してください。
This server cannot be installed
Home Assistant と統合して自然言語によるスマート ホーム制御機能を提供し、照明、気候システム、ロック、アラーム、加湿器などのデバイスをサポートするモデル コンテキスト プロトコル サーバーです。