Home Assistant MCP Server

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 モード
  • 🔒 ロック:ロック/ロック解除機能
  • 🚨 警報制御パネル: セキュリティシステムの作動/解除
  • 💧 加湿器:湿度コントロール

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

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 をインストールして長期アクセス トークンを取得する方法についての指示に従ってください。

クロードデスクトップ

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

発達

建築と出版

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

  1. 依存関係を同期し、ロックファイルを更新します。
uv sync
  1. パッケージディストリビューションをビルドします。
uv build

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

  1. 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 ライセンス - 詳細についてはライセンスを参照してください。

-
security - not tested
A
license - permissive license
-
quality - not tested

Home Assistant と統合して自然言語によるスマート ホーム制御機能を提供し、照明、気候システム、ロック、アラーム、加湿器などのデバイスをサポートするモデル コンテキスト プロトコル サーバーです。

  1. Prompts
    1. Tools
      1. Configuration
        1. Environment Variables
      2. Quickstart
        1. Install
      3. Development
        1. Building and Publishing
        2. Debugging
      4. Contributing
        1. License
          ID: 5tbc27x654