ホームアシスタントMCPサーバー

Home Assistantと連携するためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、MCP対応アプリケーションを通じてHome Assistantデバイスを制御および監視するためのツールを提供します。

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

特徴

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

インストール

このリポジトリをクローンします:

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

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

npm install

プロジェクトをビルドします。

npm run build

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
  }
});

貢献

貢献を歓迎します！ご協力いただける方法は次のとおりです。

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更をコミットします ( git commit -m 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

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

ドキュメント

MCP ツールとエコシステムに関する詳細なドキュメントについては、以下を参照してください。

www.aimcp.infoをご覧ください
ウェブサイトのMCPツールディレクトリを確認してください
統合ガイドとベストプラクティスを読む

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています - 詳細については以下を参照してください:

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.

安全

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

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

サポート

問題が発生した場合やご質問がある場合は、以下をご覧ください。

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

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

モデルコンテキストプロトコルを介して Home Assistant デバイスおよび自動化とのやり取りを可能にするサーバー。これにより、ユーザーはデバイスの状態を監視したり、デバイスを制御したり、自動化をトリガーしたり、エンティティを一覧表示したりできるようになります。

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Personal Assistant Agent
zhangzhongnan928
-
security
F
license
-
quality
A versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.
Last updated -
2
Python
Home Assistant MCP Server
miguelg719
-
security
A
license
-
quality
A Model Context Protocol server that integrates with Home Assistant to provide smart home control capabilities through natural language, supporting devices like lights, climate systems, locks, alarms, and humidifiers.
Last updated -
Python
MIT License
Hass-MCP
voska
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to interact directly with Home Assistant, allowing them to query device states, control smart home entities, and perform automation tasks.
Last updated -
15
Python
MIT License
Notion MCP Server
emmanuelsystems
-
security
F
license
-
quality
A Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.
Last updated -
275
JavaScript

View all related MCP servers

Home Assistant MCP Server