Allenporter MCP Server Home Assistant

🚀 家庭助手中的模型上下文協議服務器

本項目旨在為家庭助手創建一個模型上下文協議服務器。若想了解相關背景信息，可參閱模型上下文協議。

🚀 快速開始

✨ 主要特性

為家庭助手搭建模型上下文協議服務器，助力用戶在特定場景下更好地使用家庭助手。

📦 安裝指南

在Claude桌面中的使用方法

1. 在你的家庭助手實例中安裝家庭助手模型上下文協議自定義組件。
2. 創建一個長期訪問令牌。
3. 將此Git倉庫克隆到類似/Users/allen/Development/mcp-server-home-assistant的路徑下。
4. 編輯你的claude_desktop_config.json文件，添加類似以下內容，幷包含你的家庭助手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桌面中使用該服務器時，按照上述安裝指南的步驟操作即可。以下是編輯claude_desktop_config.json文件的代碼示例：

{
    "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.....
            }
        }
    }
}