关键词

Home Assistant小智AI智能家居语音控制物联网集成

本集成是一个 Home Assistant 插件，它在 Home Assistant 内部运行一个 MCP 服务器实例，并通过 WebSocket 协议主动连接到小智 AI 平台指定的 MCP 接入点。这样可以将 Home Assistant 的设备、实体和服务暴露为 MCP 工具，供小智 AI 调用和控制。

项目简介

这是一个 Home Assistant 集成，旨在将 Home Assistant 的强大功能与小智 AI 平台连接起来。通过实现 MCP 协议并通过 WebSocket 建立连接，该集成允许小智 AI 作为 MCP 客户端，远程访问 Home Assistant 中公开的功能，实现智能家居的语音或自动化控制。

主要功能点

  • MCP 服务器实现: 在 Home Assistant 环境下运行一个符合 MCP 标准的服务器。
  • WebSocket 连接: 通过 WebSocket 协议主动连接到外部的 MCP 客户端接入点（例如小智 AI 的服务地址）。
  • 自动工具转换: 自动将 Home Assistant 中公开给语音助手的实体和服务转换为 MCP 标准的工具 (Tools)。
  • 远程功能调用: 允许连接的 MCP 客户端（如小智 AI）通过调用这些转换后的工具来控制 Home Assistant 设备或触发服务。
  • 精简连接: 省去了传统方案中可能需要的额外代理层，直接与小智 AI 平台通信。

安装步骤

  1. 确保您的 Home Assistant 实例已安装 HACS (Home Assistant Community Store)。
  2. 在 Home Assistant 中打开 HACS。
  3. 进入 HACS 的“集成”页面。
  4. 点击右下角的“探索并下载”浮动按钮。
  5. 点击“自定义仓库”按钮。
  6. 在弹出的窗口中填写仓库信息：
    • 仓库地址 (Repository): 'https://github.com/c1pher-cn/ha-mcp-for-xiaozhi'
    • 类别 (Category): 选择 'Integration'。
  7. 点击“添加”。
  8. 在 HACS 的集成页面搜索“WebSocket MCP Server”，找到本项目。
  9. 点击进入项目详情页，点击右下角的“下载”按钮进行下载安装。
  10. 下载完成后，重启 Home Assistant 以加载新的集成。

服务器配置

本集成（在 Home Assistant 中运行）是 MCP 服务器，它需要知道连接到哪个 MCP 客户端接入点（小智 AI 平台提供的地址）。因此，大部分配置是在 Home Assistant 中完成的，指定服务器主动连接的对象。

  1. 重启 Home Assistant 后，进入“设置” > “设备与服务”。
  2. 点击右下角的“添加集成”。
  3. 搜索“Mcp”或“WebSocket MCP Server”，找到本集成。
  4. 点击本集成，开始配置流程。
  5. 在配置界面中，您需要填写：
    • 小智 MCP 接入点地址: 填写小智 AI 平台提供给您的、用于 MCP 连接的 WebSocket 地址。请注意：这是本服务器主动连接的地址，而不是提供给 MCP 客户端连接本服务器的地址。
    • Home Assistant LLM API: 选择本集成用于获取工具和 Prompt 的 Home Assistant LLM API（通常选择默认的“Assist”即可）。
  6. 点击“提交”完成配置。

配置完成后，本集成会尝试连接到指定的小智 MCP 接入点。实际的 MCP 连接成功与否以及如何与小智 AI 平台对接，还需要在小智 AI 平台的相应设置中进行。关于在 MCP 客户端（即小智 AI）如何配置以接收本服务器的连接并与之交互，请参考小智 AI 平台的官方文档或指引。您可能需要在小智 AI 平台注册本 MCP 服务器，并获取它所需的连接信息。

基本使用方法

  1. 确保按照上述步骤完成安装和配置，并且 Home Assistant 已成功连接到您在配置中指定的小智 MCP 接入点。您可以在 Home Assistant 的集成页面查看集成状态。
  2. 在 Home Assistant 中，进入“设置” > “语音助手” > “公开”。在此页面选择您希望通过小智 AI 控制或查询的 Home Assistant 实体和设备（例如灯、开关、传感器、脚本等）。这些公开的实体将被转换为 MCP 工具。
  3. 访问小智 AI 平台的相应界面或设置，确认已成功识别到您连接的 MCP 服务器，并且 Home Assistant 中公开的工具列表已同步。
  4. 现在，您应该可以通过小智 AI 的语音或文字指令来控制您在 Home Assistant 中公开的设备了。例如，对小智 AI 说出“打开客厅的灯”，小智 AI 将通过 MCP 协议调用 Home Assistant 中对应的灯实体工具来执行操作。

信息

分类

桌面与硬件

访问项目