Для чего этот сервер?

Этот сервер соединяет Home Assistant с AI-ассистентами через протокол MCP. Он даёт нейросети прямой доступ к умному дому — включать свет, проверять датчики или менять режимы. Идеально, когда нужно управлять автоматизацией голосом или текстом без ручного переключения сценариев.

Каталог MCP
allenporter/mcp-server-home-assistant

allenporter/mcp-server-home-assistant

от allenporter

MCP инструмент для Home Assistant: управляй умным домом через ИИ-ассистентов. Настройка через long-lived токен и конфиг-файл. Автоматизируй сценарии, управляй устройствами и следи за событиями.

Github Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

mcp-server-home-assistant

A Model Context Protocol Server for Home Assistant. See Model Context Protocol for context.

The custom component required by this integration is moving to Home Assistant Core in https://github.com/home-assistant/core/pull/134122

Usage in Claude Desktop

Install the home-assistant-model-context-protocol custom component in your Home Assistant instance
Create a Long Lived Access Token
Clone this git repo to a path like /Users/allen/Development/mcp-server-home-assistant

Edit your claude_desktop_config.json with something like this and include your home assistant url and api token:

{
    "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.....
            }
        }
    }
}

You can view the logs e.g. ~Library/Logs/Claude/mcp-server-Home-assistant.log to understand what is happening

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

Выберите клиент, чтобы установить allenporter/mcp-server-home-assistant:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "allenporter-mcp-server-home-assistant-w92xyq2ohu": {
      "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....."
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "allenporter-mcp-server-home-assistant-w92xyq2ohu": {
      "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....."
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "allenporter-mcp-server-home-assistant-w92xyq2ohu": {
      "type": "stdio",
      "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....."
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"allenporter-mcp-server-home-assistant-w92xyq2ohu\",\"type\":\"stdio\",\"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

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "allenporter-mcp-server-home-assistant-w92xyq2ohu": {
      "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 Code

Добавьте сервер одной командой в терминале:

claude mcp add allenporter-mcp-server-home-assistant-w92xyq2ohu --env HOME_ASSISTANT_WEB_SOCKET_URL=http://localhost:8123/api/websocket --env HOME_ASSISTANT_API_TOKEN=byJhbVci0iJIUzI1ii1sInR5cCI6IkpXVCJ9..... -- uv --directory /Users/allen/Development/mcp-server-home-assistant run mcp-server-home-assistant -v -v

Либо через JSON-конфиг:

claude mcp add-json allenporter-mcp-server-home-assistant-w92xyq2ohu "{\"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.....\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add allenporter-mcp-server-home-assistant-w92xyq2ohu --env HOME_ASSISTANT_WEB_SOCKET_URL=http://localhost:8123/api/websocket --env HOME_ASSISTANT_API_TOKEN=byJhbVci0iJIUzI1ii1sInR5cCI6IkpXVCJ9..... -- uv --directory /Users/allen/Development/mcp-server-home-assistant run mcp-server-home-assistant -v -v

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.allenporter-mcp-server-home-assistant-w92xyq2ohu]
command = "uv"
args = ["--directory", "/Users/allen/Development/mcp-server-home-assistant", "run", "mcp-server-home-assistant", "-v", "-v"]

[mcp_servers.allenporter-mcp-server-home-assistant-w92xyq2ohu.env]
HOME_ASSISTANT_WEB_SOCKET_URL = "http://localhost:8123/api/websocket"
HOME_ASSISTANT_API_TOKEN = "byJhbVci0iJIUzI1ii1sInR5cCI6IkpXVCJ9....."

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите allenporter/mcp-server-home-assistant, а в поле команды запуска — строку ниже:

uv --directory /Users/allen/Development/mcp-server-home-assistant run mcp-server-home-assistant -v -v

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "allenporter-mcp-server-home-assistant-w92xyq2ohu": {
      "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....."
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "allenporter-mcp-server-home-assistant-w92xyq2ohu": {
      "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....."
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например allenporter-mcp-server-home-assistant-w92xyq2ohu.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: allenporter-mcp-server-home-assistant-w92xyq2ohu
    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.....

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "allenporter-mcp-server-home-assistant-w92xyq2ohu": {
      "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....."
      }
    }
  }
}

Конфиг для установки сервера

{
  "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....."
  }
}