<img src="./img/ha.png" height="30" style="border-radius: 250%; margin: 0 5px;"> 🤝 <img src="./img/mcp.png" height="30" style="border-radius: 20%; margin: 0 5px;"> Home Assistant MCP 服务器

这是一个与 Home Assistant 集成的 Model Context Protocol (MCP) 服务器项目，旨在提供智能家居控制功能。

提示

该服务器为每个域的工具集提供了提示。

工具

该服务器实现了对各种 Home Assistant 域的控制。目前支持：

• 💡 灯光：开关、亮度控制
• 🌡️ 气候：温度控制、暖通空调模式
• 🔒 锁：锁定/解锁功能
• 🚨 报警控制面板：布防/撤防安全系统
• 💧 加湿器：湿度控制

示例工具包括：

light-turn_on() climate-turn_off() alarm_control_panel-disarm() lock-lock() humidifier-turn_off()

配置

环境变量

在根目录下创建一个 .env 文件，并添加以下内容：

HOMEASSISTANT_TOKEN=your_long_lived_access_token_here # 从您的 Home Assistant 实例中获取 HOMEASSISTANT_BASE_URL=your_home_assistant_url_here # 例如 http://homeassistant.local:8123

快速开始

安装

请按照说明安装 Home Assistant 并获取长期访问令牌。

• Home Assistant 入门指南

Claude Desktop

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

<details> <summary>开发/未发布的服务器配置</summary>

"mcpServers": { "home-assistant-server": { "command": "uv", "args": [ "--directory", "/path/to/home-assistant-server", "run", "home-assistant-server" ] } }

</details> <details> <summary>已发布的服务器配置</summary>

"mcpServers": { "home-assistant-server": { "command": "uvx", "args": [ "home-assistant-server" ] } }

</details>

开发

构建和发布

准备分发包：

1. 同步依赖项并更新锁文件： bash uv sync

2. 构建包分发： bash uv build

这将在 dist/ 目录中创建源码和 wheel 分发。

1. 发布到 PyPI： bash uv publish

注意：您需要通过环境变量或命令标志设置 PyPI 凭证：

• 令牌：--token 或 UV_PUBLISH_TOKEN
• 或用户名/密码：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于 MCP 服务器通过 stdio 运行，调试可能会比较困难。为了获得最佳调试体验，我们强烈建议使用 MCP Inspector。

您可以使用 npm 通过以下命令启动 MCP Inspector：

bash npx @modelcontextprotocol/inspector uv --directory /Users/miguel/Documents/home-assistant-server/home-assistant-server run home-assistant-server

启动后，Inspector 将显示一个 URL，您可以在浏览器中访问该 URL 以开始调试。

贡献

感谢您对本项目的贡献感兴趣！

请参阅 CONTRIBUTING.md 获取指南。

许可

MIT 许可 - 详情请参见 LICENSE。