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

🤝 ホームアシスタント 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

発達

建築と出版

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

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

uv sync

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

uv build

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

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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

Related Resources

Reddit Discussion about this server

Related MCP Servers

Home Assistant MCP
allenporter
-
security
A
license
-
quality
Expose all Home Assistant voice intents through a Model Context Protocol Server allowing home control.
Last updated -
30
Python
Apache 2.0
Home Assistant MCP Server
hekmon8
A
security
A
license
A
quality
A server that enables interaction with Home Assistant devices and automations through the Model Context Protocol, allowing users to monitor device states, control devices, trigger automations, and list entities.
Last updated -
4
29
JavaScript
MIT License
MCP Personal Assistant Agent
zhangzhongnan928
-
security
F
license
-
quality
A versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.
Last updated -
2
Python
Home Assistant MCP
hpohlmann
-
security
A
license
-
quality
A Model Context Protocol (MCP) integration that allows AI assistants to control Home Assistant devices by searching for entities and controlling devices through natural language commands.
Last updated -
10
Python
MIT License

View all related MCP servers

Home Assistant MCP Server