ホームアシスタントMCP

これは、Home Assistant との統合ツールを提供し、AI アシスタントがスマート ホーム デバイスと対話できるようにする MCP (Model Context Protocol) サーバーです。

設定

Smithery経由でインストール

Smithery経由で Claude Desktop の Home Assistant Integration を自動的にインストールするには:

npx -y @smithery/cli install @guilhermelirio/homeassistant-mpc --client claude

手動インストール

1. 依存関係をインストールします:

npm install

2. 環境変数を設定します。

   • ホームアシスタントから長期アクセストークンを取得する

   • プロジェクト ルートの.envファイルで環境変数を設定します。

HOME_ASSISTANT_URL=http://your-home-assistant:8123
HOME_ASSISTANT_TOKEN=your_token_here

Related MCP server: SwitchBot MCP Server

サーバーの起動

npm start

開発の場合:

npm run dev

利用可能なツール

ホームアシスタントAPI検証

• homeassistant_api : Home Assistant APIがオンラインかどうかを確認します

  • パラメータ: なし

  • 例: homeassistant_api()

エンティティの状態を取得する

• homeassistant_get_state : Home Assistantエンティティの現在の状態を取得します

  • パラメータ: entity_id (エンティティID)

  • 例: homeassistant_get_state("light.living_room")

通話サービス

• homeassistant_call_service : Home Assistantエンティティのサービスを呼び出す

  • パラメータ:

    • entity_id (エンティティID)

    • domain （サービスドメイン）

    • service （呼び出すサービス）

  • 例: homeassistant_call_service("light.living_room", "light", "turn_on")

発達

このプロジェクトでは、TypeScript と MCP SDK ライブラリを使用して、Claude、GPT などの言語モデルからアクセスできるツールを作成します。

新しいツールを追加するには:

1. src/tools/[category]にモジュールを作成する

2. 既存のパターンに従ってツールを実装する

3. src/index.tsにモジュールを登録する

貢献

貢献を歓迎します！お気軽に問題を報告したり、プルリクエストを送信してください。

ライセンス

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