mcp-server-home-assistant

基本能力

产品定位

mcp-server-home-assistant 是一个用于 Home Assistant 的 Model Context Protocol 服务器，旨在通过 Claude Desktop 实现与 Home Assistant 的集成和控制。

核心功能

1. 通过 Model Context Protocol 与 Home Assistant 实例进行通信。
2. 支持通过 Claude Desktop 配置和控制 Home Assistant 设备。
3. 提供日志记录功能，便于调试和问题排查。

适用场景

1. 智能家居设备的远程控制和管理。
2. 通过 Claude Desktop 集成 Home Assistant 功能。
3. 开发者和高级用户对 Home Assistant 进行自定义集成。

工具列表

1. home-assistant-model-context-protocol：Home Assistant 自定义组件，用于支持 Model Context Protocol。
2. Claude Desktop：用于配置和运行 mcp-server-home-assistant 的客户端工具。

常见问题解答

1. 如何获取日志：日志文件位于 ~Library/Logs/Claude/mcp-server-Home-assistant.log。
2. 如何配置 Home Assistant 连接：需要在 claude_desktop_config.json 中配置 WebSocket URL 和 API Token。

使用教程

使用依赖

1. 安装 Home Assistant 实例。
2. 安装 home-assistant-model-context-protocol 自定义组件。
3. 创建 Long Lived Access Token。

安装教程

1. 克隆 mcp-server-home-assistant 仓库到本地路径，例如 /Users/allen/Development/mcp-server-home-assistant。

2. 编辑 claude_desktop_config.json 文件，配置如下内容（替换为你的 Home Assistant URL 和 API Token）：

   json { "mcpServers": { "Home-assistant": { "command": "uv", "args": [ "--directory", "/Users/allen/Development/mcp-server-home-assistant", "run", "mcp-server-home-assistant", "-v", "-v" ], "env": { "HOME_ASSISTANT_WEB_SOCKET_URL": "http://localhost:8123/api/websocket", "HOME_ASSISTANT_API_TOKEN": "byJhbVci0iJIUzI1ii1sInR5cCI6IkpXVCJ9..... } } } }

调试方式

1. 查看日志文件 ~Library/Logs/Claude/mcp-server-Home-assistant.log 以了解运行情况。
2. 使用 -v 参数增加日志详细程度。

许可证

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