Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client