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

allenporter_mcp-server-home-assistant

一个为Home Assistant设计的模型上下文协议服务器,通过自定义组件实现与Claude桌面客户端的集成

article

README

🚀 家庭助手中的模型上下文协议服务器

本项目旨在为家庭助手创建一个模型上下文协议服务器。若你想了解相关背景信息,可参阅模型上下文协议

🚀 快速开始

在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.....
            }
        }
    }
}
  1. 你可以查看日志,例如~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. 补齐环境变量后重启客户端