返回 MCP 目录
public公开dns本地运行

homeassistant-mcp-controller

Home Assistant MCP集成套件,实现多MCP服务器(如Microsoft 365、BookStack、Loki)的全面接入与语音控制,提供统一可扩展的智能家居管理接口。

article

README

🚀 Home Assistant MCP 集成套件

本套件可将多种 MCP 服务器(模型上下文协议)全面集成至 Home Assistant 中,还提供了完整的语音控制支持。它通过统一且可扩展的接口,将 Microsoft 365、BookStack 和 Loki 等服务连接在一起,为用户带来便捷的使用体验。

🚀 快速开始

在您的 custom_components 文件夹中克隆仓库:

git clone https://github.com/username/homeassistant-mcp-integration.git custom_components/mcp_integration

然后重启 Home Assistant。

✨ 主要特性

  • 全面集成:支持多款 MCP 服务器在 Home Assistant 中的集成。
  • 统一配置:提供统一配置界面,方便用户操作。
  • 语音交互:可通过 Home Assistant Voice 实现语音控制。
  • 状态监控:自动生成传感器实体以监控连接服务。
  • 架构扩展:架构具备可扩展性,便于添加更多服务器。

📦 安装指南

# 在您的 custom_components 文件夹中克隆仓库
git clone https://github.com/username/homeassistant-mcp-integration.git custom_components/mcp_integration

# 重启 Home Assistant

📚 详细文档

项目目标

  • 全面集成:将多种 MCP 服务器整合到 Home Assistant 中。
  • 语音交互:实现与连接服务的语音控制功能。
  • 可扩展架构:支持未来新增的 MCP 服务器。
  • 稳健开发方法:采用无干扰开发流程,确保稳定性。

支持的 MCP 服务器

  • Microsoft 365:涵盖电子邮件、日历、OneDrive 以及其他 Microsoft 365 服务。
  • BookStack:一款文档管理与知识组织工具。
  • Loki:日志聚合与分析平台。

开发指南

本项目遵循结构化的开发流程,包含明确的阶段和检查点。更多详细信息,请参阅 开发手册

📄 许可证

本项目采用 MIT 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端