🤝

🤝 Home Assistant MCP サーバー

Home Assistant と統合し、スマートホームの制御機能を提供する Model Context Protocol（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

クイックスタート

インストール

Home Assistant のインストール方法と、有効期間の長いアクセストークンの取得方法については、以下の手順に従ってください。

• Home Assistant を始める

Claude Desktop

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

開発版／未公開サーバーの設定

``` "mcpServers": { "home-assistant-server": { "command": "uv", "args": [ "--directory", "/path/to/home-assistant-server", "run", "home-assistant-server" ] } } ```

公開済みサーバーの設定

``` "mcpServers": { "home-assistant-server": { "command": "uvx", "args": [ "home-assistant-server" ] } } ```

開発

ビルドと公開

パッケージを配布できるように準備するには、次の手順を実行します。

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

uv sync

2. パッケージの配布物をビルドします。

uv build

これにより、dist/ ディレクトリにソース配布物と wheel 配布物が作成されます。

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

起動すると、Inspector に URL が表示されます。その URL にブラウザーからアクセスして、デバッグを開始できます。

コントリビューション

このプロジェクトへの貢献に関心をお寄せいただき、ありがとうございます！

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

ライセンス

MIT License の詳細については、LICENSE をご覧ください。