Home Assistant MCP服务器

“Home Assistant” MCP服务器能做什么？

Home Assistant MCP服务器（hass-mcp）是一个模型上下文协议（MCP）服务器，将AI助手（如Claude及其他LLM）与您的Home Assistant生态系统连接。它通过MCP标准暴露Home Assistant的数据和功能，使AI代理能够交互、查询及控制智能家居设备和自动化。hass-mcp支持的典型任务包括查询设备与传感器状态、切换灯光或开关、汇总家庭状态、排查自动化、搜索特定实体，以及为常见智能家居活动提供引导式对话。这一集成让开发者和用户可通过对话AI、自动化与LLM代理便捷地管理智能家居。

提示词列表

• 在仓库中未找到已文档化的提示词模板。

资源列表

• 仓库中未列出明确的MCP资源。

工具列表

• 查询设备与传感器状态：允许LLM获取Home Assistant实体的当前状态。
• 控制灯光、开关及其他实体：可直接控制（开/关、亮度等）受支持的智能家居组件。
• 获取智能家居摘要：提供家庭当前状态的高层次概览或汇总信息。
• 排查自动化与实体问题：提供自动化或设备实体的诊断信息或解决步骤。
• 搜索特定实体：用户或代理可按名称或类型在Home Assistant中查找设备或传感器。
• 创建常见任务的引导式对话：支持结构化交互，帮助用户完成常用的智能家居操作。

本MCP服务器的应用场景

• 设备状态查询：开发者和用户可通过编程或对话方式请求当前状态（如“厨房窗户开着吗？”），便于监控和自动化逻辑。
• 智能家居控制：让语音助手或聊天机器人能够开关灯光、调节温控或控制家电，提升可用性和自动化体验。
• 家庭状态报告：LLM可按需生成每日或即时摘要（如“今晚我的家处于什么状态？”），方便用户或集成到仪表盘。
• 自动化排查：开发者可利用MCP服务器识别自动化中的配置错误或故障，提升调试效率。
• 实体搜索与引导流程：快速查找设备或引导用户完成多步复杂流程（如“设置晨间例行任务”），简化智能家居管理。

如何设置

Windsurf

1. 确保系统已安装Python和Docker。
2. 克隆hass-mcp仓库，并在.env文件中配置您的Home Assistant连接（参考.env.example）。
3. 在Windsurf中，打开设置中的MCP服务器部分。
4. 通过如下JSON配置添加hass-mcp服务器：

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "docker",
         "args": ["run", "--env-file=.env", "-p", "8080:8080", "voska/hass-mcp:latest"]
       }
     }
   }
   

5. 保存设置并重启Windsurf，验证服务器已出现在MCP列表中。

Claude

1. 在本地或Claude可访问的服务器上部署hass-mcp服务器。
2. 使用环境变量保护您的Home Assistant API密钥。
3. 在Claude的配置中添加MCP服务器条目：

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

4. 重启Claude并检查MCP服务器可用性。
5. 使用环境变量保护敏感数据（见下方）。

Cursor

1. 部署hass-mcp，并确保Cursor与MCP服务器之间具备网络访问。
2. 配置Cursor使用MCP服务器：

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

3. 保存配置并重启Cursor。
4. 根据需要为API密钥设置环境变量。

Cline

1. 安装依赖并运行hass-mcp服务器（详见仓库说明）。
2. 在Cline中打开您的MCP配置文件。
3. 添加hass-mcp服务器：

   {
     "mcpServers": {
       "hass-mcp": {
         "command": "python",
         "args": ["-m", "app.main"]
       }
     }
   }
   

4. 重启Cline以启用新的MCP服务器。

API密钥安全保护（所有平台）：

在您的配置中使用环境变量来保护敏感信息：

{
  "mcpServers": {
    "hass-mcp": {
      "env": {
        "HASS_TOKEN": "${HASS_TOKEN}"
      },
      "inputs": {
        "hass_url": "http://your-homeassistant.local:8123"
      }
    }
  }
}

在流程中如何使用本MCP

在FlowHunt中使用MCP

要将MCP服务器集成到您的FlowHunt工作流，请先将MCP组件添加到流程并与AI代理连接：

点击MCP组件打开配置面板。在系统MCP配置部分，使用如下JSON格式填写您的MCP服务器信息：

{
  "hass-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置完成后，AI代理即可作为工具访问MCP的全部功能。请记得将"hass-mcp"替换为您实际的MCP服务器名称，并将URL替换为您自己的MCP服务器地址。

概览

根据现有文档及仓库内容，hass-mcp为Home Assistant的MCP集成提供了坚实基础，具备清晰的工具支持及合理的安装/安全实践。但公开文档中缺乏明确的提示词模板、资源定义及高级采样/根特性。综合来看，我为本MCP服务器打分为6/10：功能完善且对开发者友好，但在可扩展性文档和高级MCP特性上仍有不足。

MCP评分