Homeassistant Server MCP

🚀 家庭助手 MCP サーバー

家庭用アシスタントとのやり取りを行うためのモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは、MCP 対応アプリを通じて家庭用アシスタントデバイスを制御および監視するためのツールを提供します。

このプロジェクトは、AI モデルコンテキストプロトコル（MCP）エコシステムの一部です。MCP ツールに関する詳細情報とドキュメントは、www.aimcp.info をご覧ください。

🚀 クイックスタート

このサーバーを使用することで、家庭用アシスタントデバイスの制御や監視が可能になります。以下の手順でセットアップを行い、利用を開始しましょう。

✨ 主な機能

• デバイスの状態を取得する
• デバイスの状態を制御する（オン/オフ）
• 自動化をトリガーする
• 利用可能なエンティティを一覧表示する

📦 インストール

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）に以下の内容を追加してサーバーを設定します：

{
  "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 を、あなたの家庭用アシスタントインスタンスの URL とアクセストークンに置き換えてください。

💻 使用例

基本的な使用法

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

// 示例用法
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "get_state",
  arguments: {
    entity_id: "light.living_room"
  }
});

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

// 示例用法
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "toggle_entity",
  arguments: {
    entity_id: "switch.bedroom",
    state: "on" // 或 "off"
  }
});

3. 自動化をトリガーする

// 示例用法
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "trigger_automation",
  arguments: {
    automation_id: "your_automation_id"
  }
});

4. 利用可能なエンティティを一覧表示する

// 示例用法
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "list_entities",
  arguments: {}
});

📚 ドキュメント

🔧 セキュリティ

このサーバーを安全に使用するためには、以下の点に注意してください。

• 常に HTTPS を使用して家庭用アシスタントインスタンスにアクセスします。
• アクセストークンを安全に保管し、バージョン管理には決してコミットしないでください。
• 定期的にアクセストークンを更新します。
• 環境変数を使用して機密情報を保管します。

🆘 サポート

何か問題が発生した場合や質問がある場合は、以下の手順を行ってください。

1. リポジトリ内の既存の問題を確認します。
2. まだ報告されていない問題の場合は、新しい問題を作成します。
3. 問題を報告する際には、できるだけ多くのコンテキストを提供してください。
4. さらなるサポートリソースについては、www.aimcp.info をご覧ください。