hass-mcp-server

概述

这个 MCP 服务器使 AI 助手如 Claude 能够通过 HTTP 传输与 Home Assistant 交互，提供 OAuth 和长期令牌两种认证方式。它提供对 Home Assistant 功能的全面访问，包括实体管理、自动化控制、配置文件管理、仪表板操作和系统管理。该服务器专门需要 OAuth 2.0 认证的基于 Web 的 AI 客户端设计，满足了官方仅支持 SSE 的集成未能满足的需求。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• get_state

  Get the current state of any entity

  试试:What's the current temperature of the living room?试试:Show me the status of all lights
• list_entities

  List all entities with optional domain filter

  试试:List all sensors in the house试试:Show me all lights in the kitchen
• call_service

  Call any Home Assistant service

  试试:Turn on the living room light试试:Set thermostat to 72 degrees
• list_automations

  List all automations with full configuration

  试试:Show me all my automations试试:List all automations that trigger at sunset
• get_automation_config

  Get full configuration of a single automation

  试试:Show me the configuration for morning routine automation试试:What does the away mode automation do?
• create_automation

  Create a new automation

  试试:Create an automation to turn on lights at sunset试试:Make an automation that turns off all lights when I leave
• list_dashboards

  List all Lovelace dashboards with metadata

  试试:Show me all my dashboards试试:List all dashboards in the house
• get_dashboard_config

  Get full dashboard configuration

  试试:Show me the configuration of the main dashboard试试:What's on my energy dashboard?
• list_config_files

  List all YAML files in the config directory

  试试:Show me all configuration files试试:List all YAML files in the config folder
• get_system_status

  Get system overview including version, domain counts, and entity totals

  试试:What's the current status of Home Assistant?试试:Show me system statistics
• list_devices

  List devices, optionally filtered by area

  试试:Show me all devices in the living room试试:List all smart home devices
• list_services

  List available services, optionally filtered by domain

  试试:Show me all available services试试:List all services for the light domain

可对比工具

安装

{
  "mcpServers": {
    "home-assistant": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-homeassistant"],
      "env": {
        "HOME_ASSISTANT_URL": "https://your-home-assistant.com",
        "HOME_ASSISTANT_TOKEN": "your-long-lived-token"
      }
    }
  }
}

FAQ

如何列出所有自动化、场景或脚本？

使用专用列表工具：`list_automations()`、`list_scenes()` 或 `list_scripts()` 获取完整配置。

OAuth 和长期令牌认证有什么区别？

OAuth 用于像 Claude 这样的基于浏览器的客户端，需要 hass-oidc-server 集成。长期令牌用于本地客户端，无需额外依赖即可使用。

hass-mcp-server 对比