Home Assistant Mcp Agent

🚀 LiveKit 代理与 Home Assistant MCP 服务器集成

本项目致力于将 LiveKit Agents 集成至 Home Assistant 的 模型上下文协议（MCP）服务器 中，借助 LiveKit 代理达成智能家居的语音控制功能，为用户带来更加便捷、智能的家居体验。

🚀 快速开始

此集成功能丰富多样，具体如下：

• 可通过 LiveKit 代理以语音的方式控制 Home Assistant 设备。
• 实现实时音频/视频在 AI 助手之间的流畅通信。
• 能够通过 MCP 访问 Home Assistant 实体和服务。

✨ 主要特性

本项目具备以下突出特性：

• 语音控制：借助 LiveKit 代理，用户可以使用语音指令对 Home Assistant 设备进行控制，操作更加便捷高效。
• 实时通信：支持实时音频/视频与 AI 助手之间的通信，确保信息的及时传递和交互。
• 实体与服务访问：通过 MCP 协议，能够轻松访问 Home Assistant 的实体和服务，拓展了系统的功能和应用场景。

📦 安装指南

在进行安装配置之前，需要满足以下先决条件：

• 已完成 Home Assistant 的配置，并启用了 MCP 服务器插件。
• 完成 LiveKit 和 OpenAI 的相关设置。
• 具备运行代理的 Python 环境。

具体的安装配置步骤如下：

1. 依据 官方文档 对 Home Assistant MCP 服务器进行配置。
2. 利用 LiveKit Agents 框架 设置您的 LiveKit 代理。
3. 使用您的 Home Assistant URL 和访问令牌对代理进行配置。

💻 使用示例

基础用法

以下是配置示例代码：

# 示例配置
LIVEKIT_URL = "wss://your-livekit-server.com"
LIVEKIT_API_KEY = "your-api-key"
LIVEKIT_API_SECRET = "your-api-secret"

OPENAI_API_KEY

HOME_ASSISTANT_URL = "http://your-homeassistant:8123/mcp_server/sse"
HOME_ASSISTANT_TOKEN = "your-long-lived-access-token"

你可以根据实际情况修改上述配置信息，以适应你的使用需求。