🤝Home Assistant MCP Server

基本能力

产品定位

Home Assistant MCP Server 是一个智能家居控制服务，通过与 Home Assistant 集成，提供对多种智能家居设备的控制能力。

核心功能

• 灯光控制：开关控制、亮度调节
• 气候控制：温度控制、HVAC 模式调节
• 锁具控制：锁定/解锁功能
• 警报控制面板：安全系统的布防/撤防
• 加湿器控制：湿度调节

适用场景

• 智能家居系统的集中控制
• 通过 MCP 协议实现自动化控制
• 开发智能家居相关的应用和服务

工具列表

• light-turn_on()：打开灯光
• climate-turn_off()：关闭气候控制
• alarm_control_panel-disarm()：撤防警报系统
• lock-lock()：锁定锁具
• humidifier-turn_off()：关闭加湿器

常见问题解答

• 如何获取 Home Assistant 的访问令牌？：在 Home Assistant 实例中完成 onboarding 后获取长寿命访问令牌。
• 如何调试 MCP 服务器？：推荐使用 MCP Inspector 进行调试。

使用教程

使用依赖

1. 安装 Home Assistant 并获取长寿命访问令牌。
2. 参考 Home Assistant Getting Started

安装教程

1. 创建 .env 文件并配置环境变量： HOMEASSISTANT_TOKEN=your_long_lived_access_token_here HOMEASSISTANT_BASE_URL=your_home_assistant_url_here
2. 对于开发或未发布的服务，配置 mcpServers： json "mcpServers": { "home-assistant-server": { "command": "uv", "args": [ "--directory", "/path/to/home-assistant-server", "run", "home-assistant-server" ] } }
3. 对于已发布的服务，配置 mcpServers： json "mcpServers": { "home-assistant-server": { "command": "uvx", "args": [ "home-assistant-server" ] } }

调试方式

1. 使用 MCP Inspector 进行调试： bash npx @modelcontextprotocol/inspector uv --directory /Users/miguel/Documents/home-assistant-server/home-assistant-server run home-assistant-server
2. 访问 Inspector 提供的 URL 进行调试。

开发

构建和发布

1. 同步依赖并更新锁文件： bash uv sync
2. 构建包分发： bash uv build
3. 发布到 PyPI： bash uv publish
4. 需要设置 PyPI 凭证（通过环境变量或命令行标志）。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。