Model Context Protocol Server for Home Assistant

Name: Model Context Protocol Server for Home Assistant
Author: tevonsb

@tevonsb

代码仓库

关于 Model Context Protocol Server for Home Assistant

A MCP server for Home Assistant

基本信息

分类

AI 与智能体

许可证

Apache-2.0

运行时

node

传输方式

stdio

发布者

tevonsb

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "homeassistant-mcp": {
      "command": "docker",
      "args": [
        "compose",
        "up",
        "-d"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Model Context Protocol Server for Home Assistant?

It is an MCP server that bridges a local Home Assistant instance with Language Learning Models (LLMs), enabling natural language control and monitoring of smart home devices. It provides a comprehensive API for device control, automation management, add-on management, and package management (HACS).

How to use Model Context Protocol Server for Home Assistant?

Install via Node.js (npm install, npm run build) or Docker Compose. Configure environment variables: HASS_HOST, HASS_TOKEN, HASS_SOCKET_URL, and server options. Run the server and connect an MCP client (e.g., Claude Desktop) by adding the server to the client config with the command node <path>/dist and environment variables.

Key features of Model Context Protocol Server for Home Assistant

Control lights, climate, covers, switches, sensors, media players, fans, locks, vacuums, cameras.
Real‑time updates via Server‑Sent Events (SSE).
Manage Home Assistant add‑ons (install, start, stop, restart).
Full integration with Home Assistant Community Store (HACS) packages.
Create, duplicate, enable/disable automations with complex triggers, conditions, actions.
Token‑based authentication and rate limiting; Docker support.

Use cases of Model Context Protocol Server for Home Assistant

Use natural language to turn on lights, adjust thermostats, or control media players.
Monitor real‑time device state changes and automation executions through SSE.
Automate routine tasks by creating or modifying automations programmatically.
Manage add‑ons and HACS packages from an LLM interface.

FAQ from Model Context Protocol Server for Home Assistant

What are the prerequisites?

Node.js 20.10.0+, npm, Docker Compose (optional), a running Home Assistant instance with a long‑lived access token, and optionally HACS and Supervisor for full features.

How do I configure the server?

Set environment variables in a .env file: HASS_HOST, HASS_TOKEN, HASS_SOCKET_URL, PORT, NODE_ENV, DEBUG. Use .env.example as a template.

Can I deploy with Docker?

Yes, Docker Compose is recommended. Clone the repo, copy .env.example to .env, edit the configuration, then run docker compose up -d. The server runs on port 3000.

What transports and authentication are supported?

The server uses HTTP endpoints with token‑based authentication (the HASS_TOKEN). Real‑time updates use SSE over HTTP. No other transports are mentioned.

Are there any known limits?

No limits are stated in the README. The server supports rate limiting and has extensive test coverage (95%).

AI 与智能体分类下的更多 MCP 服务器

MCP Client for Ollama (ollmcp)

jonigl

Harness the power of local LLMs with this TUI MCP Client for Ollama. Featuring all core MCP primitives (tools, prompts, resources), agent mode, multi-server, model switching, streaming responses, human-in-the-loop, thinking mode, model params config, system prompts, and saved pre

768