Hekmon8 Homeassistant Server MCP

🚀 家庭助手 MCP サーバ

このサーバは、Home Assistant とのインタラクションを可能にする Model Context Protocol (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 にある 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. 機器の状態を取得する

// 示例用法
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: "automation.morning_routine"
  }
});

4. エンティティをリストする

// 示例用法
use_mcp_tool({
  server_name: "homeassistant",
  tool_name: "list_entities",
  arguments: {
    domain: "light"  // 可选，按领域过滤
  }
});

🤝 貢献

貢献を歓迎します！以下の手順で貢献することができます。

1. リポジトリをフォークします。
2. 機能ブランチを作成します（git checkout -b feature/your-feature-name）。
3. 変更をコミットし、プルリクエストを作成します。

コミットする前に、コードフォーマットをチェックし、単体テストを記述することを確認してください。

🔧 技術詳細

このプロジェクトでは、以下の技術とツールを使用しています。

• サーバの構築には Node.js と npm を使用しています。
• 依存関係管理
• ビルドシステム

📄 ライセンス

このプロジェクトは、MIT License に基づいて公開されています。

🆘 サポート

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

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