Home Assistant MCP Server

Home Assistant MCP サーバー

🌟 スポンサー

ウェブサイト	説明
ProductDirs.com	AI ツールディレクトリ＆ローンチプラットフォーム — AI SaaS 製品、スタートアップ、開発者向けツールをコミュニティ主導のランキングで見つけて紹介する、無料の掲載サービスです
ThisTools.app	AI SaaS 発見プラットフォーム — 人工知能ソフトウェア、自動化ツール、生産性アプリケーションを厳選したコレクションとともに掲載する、無料のディレクトリです
AIImgCombiner.com	AI 搭載の画像融合ツール — 人工知能を使って写真を結合・合成できる無料のオンラインサービスです。プロ品質の結果を得られる、プリセットスタイルとカスタムプロンプトを利用できます

Home Assistant と連携するための Model Context Protocol（MCP）サーバーです。このサーバーは、MCP 対応アプリケーションから Home Assistant デバイスを操作・監視するためのツールを提供します。

このプロジェクトは、AI Model Context Protocol（MCP）エコシステムの一部です。MCP ツールの詳細やドキュメントについては、www.aimcp.info をご覧ください。

機能

• デバイスの状態を取得
• デバイスの状態を操作（オン／オフ）
• オートメーションを実行
• 利用可能なエンティティを一覧表示

インストール

Smithery 経由でインストール

Smithery 経由で Claude Desktop に Home Assistant MCP サーバーを自動インストールするには：

npx -y @smithery/cli install @hekmon8/Homeassistant-server-mcp --client claude

手動インストール

1. このリポジトリをクローンします：

git clone https://github.com/yourusername/homeassistant-server-mcp.git
cd homeassistant-server-mcp

2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

4. MCP 設定ファイル（VSCode の場合、通常は ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json にあります）に次の内容を追加して、MCP サーバーを設定します：

{
  "mcpServers": {
    "homeassistant": {
      "command": "node",
      "args": ["/path/to/homeassistant-mcp/homeassistant-server/build/index.js"],
      "env": {
        "HA_URL": "http://your-homeassistant-url:8123",
        "HA_TOKEN": "your-long-lived-access-token"
      }
    }
  }
}

your-homeassistant-url と your-long-lived-access-token を、Home Assistant インスタンスの URL とアクセストークンに置き換えてください。

使い方

サーバーは次のツールを提供します：

1. デバイスの状態を取得

// Example usage
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "get_state",
  arguments: {
    entity_id: "light.living_room"
  }
});

2. デバイスの状態を切り替え

// Example usage
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "toggle_entity",
  arguments: {
    entity_id: "switch.bedroom",
    state: "on"  // or "off"
  }
});

3. オートメーションを実行

// Example usage
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "trigger_automation",
  arguments: {
    automation_id: "automation.morning_routine"
  }
});

4. エンティティを一覧表示

// Example usage
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "list_entities",
  arguments: {
    domain: "light"  // optional, filters by domain
  }
});

貢献

貢献を歓迎します！次の方法でご協力いただけます：

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

適宜テストを更新し、既存のコードスタイルに従ってください。

ドキュメント

MCP ツールとエコシステムの詳細なドキュメントについては：

• www.aimcp.info にアクセスしてください
• ウェブサイトの MCP ツールディレクトリをご確認ください
• インテグレーションガイドとベストプラクティスをお読みください

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は以下をご覧ください：

MIT License

Copyright (c) 2024 homeassistant-mcp

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

セキュリティ

このサーバーを安全に使用するには：

1. Home Assistant インスタンスでは常に HTTPS を使用してください
2. アクセストークンを安全に保管し、バージョン管理にコミットしないでください
3. アクセストークンを定期的にローテーションしてください
4. 機密情報には環境変数を使用してください

サポート

問題が発生した場合や質問がある場合は、次の手順をお試しください：

1. リポジトリに既存の課題がないか確認してください
2. 問題が報告されていない場合は、新しい課題を作成してください
3. 問題を報告する際は、できるだけ詳しい情報を記載してください
4. 追加のサポート情報については、www.aimcp.info をご覧ください