Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client