hass-mcp

概述

Hass-MCP 是一个全面的 MCP 服务器，连接 AI 助手与 Home Assistant 智能家居系统。它提供查询设备状态、控制灯光和开关、管理自动化以及解决问题的工具。服务器实现了多个 MCP 端点，包括实体操作工具、域摘要和自动化支持功能，以及访问详细实体信息的资源。通过优化 JSON 响应以提高令牌效率，它专为与 Claude Desktop 和其他兼容的 MCP 客户端无缝集成而设计。

试试问 AI

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

• get_version

  Get the Home Assistant version

  试试:What's my Home Assistant version?
• get_entity

  Get the state of a specific entity with optional field filtering

  试试:What's the current state of my living room lights?试试:Get temperature from my kitchen sensor
• entity_action

  Perform actions on entities (turn on, off, toggle)

  试试:Turn off all the lights in the kitchen试试:Toggle my bedroom fan
• list_entities

  Get a list of entities with optional domain filtering and search

  试试:List all my sensors that contain temperature data试试:Show me all light entities
• search_entities_tool

  Search for entities matching a query

  试试:Search for entities related to my living room试试:Find all climate control devices
• domain_summary_tool

  Get a summary of a domain's entities

  试试:Give me a summary of my climate entities试试:Show me information about all switch entities
• list_automations

  Get a list of all automations

  试试:List all my automations试试:Show me motion sensor automations
• call_service_tool

  Call any Home Assistant service

  试试:Restart Home Assistant试试:Reload all automations
• restart_ha

  Restart Home Assistant

  试试:Restart Home Assistant试试:Reboot my Home Assistant instance
• get_history

  Get the state history of an entity

  试试:Get history of my living room temperature sensor试试:Show me motion detection history for the past day
• get_error_log

  Get the Home Assistant error log

  试试:Show me recent Home Assistant errors试试:Why is my automation failing?
• create_automation

  Guide for creating Home Assistant automations based on trigger type

  试试:Create an automation that turns on lights at sunset试试:Help me make a motion sensor automation

可对比工具

安装

docker pull voska/hass-mcp:latest

{
  "mcpServers": {
    "hass-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "HA_URL",
        "-e",
        "HA_TOKEN",
        "voska/hass-mcp"
      ],
      "env": {
        "HA_URL": "http://homeassistant.local:8123",
        "HA_TOKEN": "您的长期访问令牌"
      }
    }
  }
}

FAQ

Hass-MCP 需要什么权限？

Hass-MCP 需要 Home Assistant 的长期访问令牌，该令牌应具有足够的权限来控制设备和访问实体数据。

除了 Claude，我还可以将 Hass-MCP 与其他 AI 助手一起使用吗？

是的，Hass-MCP 兼容任何实现模型上下文协议的 MCP 客户端，包括 Cursor 和 Claude Code CLI。

Hacker News 讨论

开发者社区最近的相关讨论。

• Hass-mcp: Home Assistant MCP server to integrate with Claude▲ 3
  帖子 by voska · 2025-03-17
• Home Assistant MCP Server▲ 1
  帖子 by voska · 2025-08-21

hass-mcp 对比