Home Assistant MCP Server

🚀 家庭助手 MCP サーバ

Home Assistant と統合するための Model Context Protocol (MCP) サーバです。これにより、LLM がスマートホームを制御およびクエリできます。

✨ 主な機能

• 自然言語で家庭助手のエンティティをクエリおよび制御することができます。
• 任意の MCP 互換クライアント（例：Claude Desktop）をサポートします。
• 状態管理、サービス呼び出し、履歴記録などのツールを提供します。
• 家庭助手の長期アクセストークンを使用した安全な認証を行います。
• 複数のトランスポートオプションがあります（ローカルプロセス用の標準入出力、リモートクライアント用の SSE）。
• 家庭助手がない場合に、モックデータを使用してテストやデモを行うデモモードがあります。

📦 インストール

# bun を使ってグローバルにインストール
bun install -g home-assistant-mcp-server

# またはソースコードからインストール
git clone https://github.com/oleander/home-assistant-mcp-server.git
cd home-assistant-mcp-server
bun install
bun run build
bun link

📚 ドキュメント

設定

現在のディレクトリに .env ファイルを作成し、以下の変数を含めます。

# 必須設定
HASS_URL=http://your-home-assistant:8123  # 家庭助手インスタンスの URL
HASS_TOKEN=your_long_lived_access_token   # 長期使用のアクセストークン

# オプション設定
PORT=3000                # HTTP サーバのポート（デフォルト：3000）
HASS_MOCK=false          # 家庭助手がない場合にテストやデモ用のモックデータモードを有効にする（デフォルト：false）

環境変数

長期アクセストークンを取得するには：

1. あなたの家庭助手インスタンスにログインします。
2. 左下のプロファイルをクリックします。
3. 「長寿命アクセストークン」までスクロールします。
4. 説明的な名前の新しいトークンを作成します。
5. トークンの値をコピーします（再度表示されることはありません）。

💻 使用例

基本的な使用法

独立したサーバとして実行

# 標準モード（実行中の家庭助手インスタンスが必要）
home-assistant-mcp-server                # HTTP/SSE トランスポートで起動
home-assistant-mcp-server --stdio       # 標準入出力で起動

# デモモード
npm start -- --mock

Claude Desktop への統合

MCP サーバを環境変数として設定します。

export MCP_SERVER_URL=http://localhost:5005
export MCP_SERVER_INSECURE=true

その後、Claude を実行します。

🔧 技術詳細

セキュリティに関する注意事項

• 不安全なネットワークでトークンを公開しないでください。
• 制限付きの権限を持つトークンを使用することを検討してください。
• セキュリティを強化するために、定期的にトークンを更新してください。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルを参照してください。