Advanced Homeassistant MCP

🚀 家庭助理帮助器

家庭助理帮助器は、Home Assistantと統合するためのツールです。コマンドラインやスクリプトを通じて、スマートホーム機器を簡単に制御できます。

🚀 クイックスタート

家庭助理帮助器をすぐに使い始めるには、以下の手順に従ってください。

依存関係のインストール

npm install home-assistant-ui-js@latest home-assistant-config-js@latest --save-dev

環境変数の設定

.env ファイルを作成または編集し、以下の内容を追加します。

HASS_HOST=http://localhost:8123
HASS_TOKEN=your_api_token_here

サービスの起動

npm run start

📚 詳細ドキュメント

設定ファイル

config.json ファイルを編集して、サービスを追加または変更します。

{
  "presets": {
    "default": {
      "brightness_pct": 75,
      "color_temp_k": 4000,
      "fan_speed": "high",
      "hvac_mode": "heat",
      "hvac_temp": 72,
      "light_color": "white"
    }
  },
  "devices": {
    "your_device_name": {
      "device_type": "light",
      "unique_id": "1234567890"
    }
  }
}

コマンドラインオプション

以下のコマンドを実行して、サービスを管理します。

# サービスの起動
node index.js start

# サービスの停止
node index.js stop

# 設定の再読み込み
node index.js reload

🛠️ 開発環境

依存関係のインストール

npm install home-assistant-ui-js@latest home-assistant-config-js@latest --save-dev

開発サーバーの起動

npm run dev

アプリケーションのビルド

npm run build

📄 API ドキュメント

概要

家庭助理帮助器は、スマートホーム機器を制御するための一連のAPIを提供します。これらのAPIを使用すると、HTTPリクエストを通じてHome Assistantとやり取りできます。

依存関係のインストール

プロジェクトで家庭助理帮助器を使用するには、以下の依存関係をインストールします。

npm install home-assistant-ui-js@latest home-assistant-config-js@latest --save-dev

設定ファイルの作成

スマートホーム機器を設定するために、config.json ファイルを作成します。

{
  "presets": {
    "default": {
      "brightness_pct": 75,
      "color_temp_k": 4000,
      "fan_speed": "high",
      "hvac_mode": "heat",
      "hvac_temp": 72,
      "light_color": "white"
    }
  },
  "devices": {
    "your_device_name": {
      "device_type": "light",
      "unique_id": "1234567890"
    }
  }
}

リクエストの例

ライトの明るさを制御する

curl -X POST http://localhost:8080/api/light/brightness \
     -H 'Content-Type: application/json' \
     -d '{"brightness_pct": 100}'

現在の温度を取得する

curl -X GET http://localhost:8080/api/hvac/temperature

💻 家庭助理帮助器の使用方法

インストール

家庭助理帮助器をインストールするには、以下のコマンドを実行します。

npm install -g homeassistant-cli

設定

インストールが完了したら、config.json という設定ファイルを作成し、以下の内容を追加します。

{
  "auth": {
    "token": "your_home_assistant_token"
  },
  "host": "http://localhost:8123"
}

コマンドラインオプション

家庭助理帮助器には、多くの便利なコマンドラインオプションが用意されています。

利用可能なすべてのデバイスをリストする

homeassistant-cli devices list

ライトの明るさを制御する

homeassistant-cli light brightness 75

⚙️ 家庭助理帮助器の設定

照明機器

config.json で照明機器を設定するには、以下のように記述します。

{
  "lights": {
    "your_light_name": {
      "state": "on",
      "brightness_pct": 75,
      "color_temp_k": 4000
    }
  }
}

HVAC機器

config.json でHVAC機器を設定するには、以下のように記述します。

{
  "hvac": {
    "your_hvac_name": {
      "state": "heat",
      "temperature": 72,
      "fan_speed": "high"
    }
  }
}

ファン機器

config.json でファン機器を設定するには、以下のように記述します。

{
  "fans": {
    "your_fan_name": {
      "state": "on",
      "speed": "medium"
    }
  }
}

🛠️ 家庭助理帮助器の開発

リポジトリのクローン

家庭助理帮助器の開発を始めるには、GitHubリポジトリをクローンします。

git clone https://github.com/yourusername/homeassistant-cli.git

テストの実行

以下のコマンドを実行して、テストサーバーを起動します。

npm run test

アプリケーションのビルド

アプリケーションを配布用にパッケージ化するには、以下のコマンドを実行します。

npm run build

🧩 家庭助理帮助器の拡張

家庭助理帮助器は、プラグインやカスタムスクリプトを使って拡張できます。新しいプラグインを作成するには、plugins ディレクトリにJavaScriptファイルを追加します。

新しいプラグインの作成

plugins ディレクトリに新しいプラグインを作成するには、以下のように記述します。

module.exports = {
  name: 'Your Plugin Name',
  description: 'What your plugin does',
  command: function(args, done) {
    // ここにプラグインのロジックを実装する
    done();
  }
};

プラグインの使用

家庭助理帮助器でプラグインを使用するには、それを plugins ディレクトリに配置し、以下のコマンドを実行します。

homeassistant-cli plugin your_plugin_name run

🚑 家庭助理帮助器のトラブルシューティング

一般的な問題

• Home Assistantに接続できない：config.json ファイルの host と token が正しいことを確認してください。
• 権限の問題：使用しているAPIトークンが必要な操作を実行するのに十分な権限を持っていることを確認してください。
• デバイスが見つからない：家庭助理帮助器のログを確認して、詳細な情報を取得してください。

ログの確認

家庭助理帮助器のログを表示するには、以下のコマンドを実行します。

homeassistant-cli --verbose

問題の報告

問題が発生した場合や改善提案がある場合は、GitHubリポジトリのIssuesセクションに報告してください。