返回 MCP 目录
public公开dns本地运行

mcp-server-home-assistant

为Home Assistant提供模型上下文协议服务的集成组件

article

README

🚀 mcp-server-home-assistant

这是一个适用于Home Assistant的模型上下文协议服务器。若您想了解相关背景信息,可访问模型上下文协议。此外,此集成所需的自定义组件正在迁移至Home Assistant Core,详情见此处

🚀 快速开始

✨ 主要特性

  • 作为适用于Home Assistant的模型上下文协议服务器,为相关操作提供支持。
  • 相关自定义组件正逐步迁移到Home Assistant Core ,以提升集成性和稳定性。

📦 安装指南

此安装指南主要针对在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.....
            }
        }
    }
}

💻 使用示例

基础用法

完成上述安装步骤后,即可在Claude Desktop中使用该服务器。若您想了解运行情况,可以查看日志,例如~Library/Logs/Claude/mcp-server-Home-assistant.log以了解发生了什么。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端