MCP Server Home Assistant

🚀 mcp-server-home-assistant

Home Assistant用のモデルコンテキストプロトコルサーバーです。背景情報については、モデルコンテキストプロトコルをご覧ください。

この統合に必要なカスタムコンポーネントは、Home Assistant Coreに移行されています。詳細はこちらを参照してください。

🚀 クイックスタート

✨ 主な機能

このサーバーは、Home Assistantとの連携を通じて、モデルコンテキストプロトコルを利用するためのインターフェースを提供します。

📦 インストール

Claude Desktopでの使用手順

1. あなたのHome Assistantインスタンスに、home-assistant-model-context-protocolカスタムコンポーネントをインストールします。
2. 長期アクセストークンを作成します。
3. このGitリポジトリを/Users/allen/Development/mcp-server-home-assistantのようなパスにクローンします。
4. claude_desktop_config.jsonファイルを編集し、以下のような内容を追加し、あなたのHome Assistant URLとAPIトークンを含めます。

{
    "mcpServers": {
        "Home-assistant": {
            "command": "uv",
            "args": [
                "--directory",
                "/Users/allen/Development/mcp-server-home-assistant",
                "run",
                "mcp-server-home-assistant",
                "-v",
                "-v"
            ],
            "env": {
                "HOME_ASSISTANT_WEB_SOCKET_URL": "http://localhost:8123/api/websocket",
                "HOME_ASSISTANT_API_TOKEN": "byJhbVci0iJIUzI1ii1sInR5cCI6IkpXVCJ9.....
            }
        }
    }
}

5. ログを確認することで、何が起こっているかを把握できます。例えば、~Library/Logs/Claude/mcp-server-Home-assistant.logを参照してください。

💻 使用例

基本的な使用法

上記の手順に従って設定することで、Claude DesktopでHome Assistantとの連携を開始できます。

{
    "mcpServers": {
        "Home-assistant": {
            "command": "uv",
            "args": [
                "--directory",
                "/Users/allen/Development/mcp-server-home-assistant",
                "run",
                "mcp-server-home-assistant",
                "-v",
                "-v"
            ],
            "env": {
                "HOME_ASSISTANT_WEB_SOCKET_URL": "http://localhost:8123/api/websocket",
                "HOME_ASSISTANT_API_TOKEN": "byJhbVci0iJIUzI1ii1sInR5cCI6IkpXVCJ9.....
            }
        }
    }
}