MCP Server Home Assistant

為Home Assistant提供模型上下文協議服務的集成組件

家庭自動化與物聯網開發者工具 #智能家居 #協議服務 #集成組件 .Python

評分 : 2.5分

下載量 : 9.2K

更新時間 : 2025-04-29

打開站點

什麼是MCP服務器?

MCP服務器是一個協議層，允許不同系統間通過統一接口進行交互。它使Home Assistant能夠與其他智能設備無縫協作，提供更強大的智能家居體驗。

如何使用MCP服務器?

安裝MCP服務器後，您可以通過簡單的配置將其連接到Home Assistant，從而控制您的家庭設備。

適用場景

適合希望集中管理和控制智能家居設備的用戶，尤其是已有Home Assistant基礎架構的家庭。

主要功能

Home Assistant集成

支持通過MCP協議直接訪問Home Assistant中的所有智能設備。

即時狀態同步

確保設備狀態在所有連接的終端上保持一致。

多平臺兼容

適配多種操作系統和硬件環境。

優勢

簡化智能家居設備管理流程。

提升跨平臺協作效率。

增強用戶體驗，減少複雜操作步驟。

侷限性

需要一定的網絡環境支持。

初次配置可能較為繁瑣。

如何使用

安裝MCP服務器

在Home Assistant實例中安裝home-assistant-model-context-protocol插件。

生成API令牌

登錄Home Assistant賬戶，生成一個長生命週期API令牌。

配置MCP服務器

編輯claude_desktop_config.json文件，添加MCP服務器相關信息。

使用案例

案例1：控制燈光

通過MCP服務器遠程開啟或關閉客廳燈光。

案例2：調節溫度

調整恆溫器溫度至22°C。

常見問題

如何檢查MCP服務器是否正常工作？

如果忘記API令牌怎麼辦？

🚀 mcp-server-home-assistant

適用於Home Assistant的模型上下文協議服務器。該服務器藉助模型上下文協議，為Home Assistant提供了更強大的功能支持。若想了解更多背景信息，請訪問模型上下文協議。

此集成所需的自定義組件正遷移到Home Assistant Core，詳情見此處。

🚀 快速開始

✨ 主要特性

作為適用於Home Assistant的模型上下文協議服務器，提供特定的協議服務。
相關自定義組件正遷移至Home Assistant Core，有望帶來更穩定和集成化的體驗。

📦 安裝指南

在Claude Desktop中的使用

在您的Home Assistant實例中安裝home-assistant-model-context-protocol自定義組件。
創建一個長期訪問令牌。
將此Git倉庫克隆到類似/Users/allen/Development/mcp-server-home-assistant的路徑下。
編輯您的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.....
            }
        }
    }
}

您可以查看日誌，例如~Library/Logs/Claude/mcp-server-Home-assistant.log以瞭解發生了什麼。

💻 使用示例

基礎用法

在Claude Desktop中使用該服務器時，按照上述安裝指南完成配置後，即可正常使用模型上下文協議服務。通過配置claude_desktop_config.json文件，將服務器與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.....
            }
        }
    }
}