什么是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.....
            }
        }
    }
}