mcp-server-home-assistant

基本能力

产品定位

该mcp-server是一个专为Home Assistant设计的模型上下文协议服务器，用于在Claude Desktop环境中与Home Assistant实例进行交互和控制。

核心功能

1. 与Home Assistant实例的WebSocket API进行通信
2. 支持通过Long Lived Access Token进行认证
3. 提供日志记录功能，便于调试和问题排查

适用场景

1. 在Claude Desktop环境中集成Home Assistant功能
2. 自动化控制和管理Home Assistant设备和服务
3. 开发与Home Assistant相关的自动化脚本和工具

工具列表

1. home-assistant-model-context-protocol: Home Assistant的自定义组件，用于支持MCP协议
2. Claude Desktop: 运行该mcp-server的客户端环境

常见问题解答

1. 日志文件位置: ~Library/Logs/Claude/mcp-server-Home-assistant.log
2. 认证问题: 需要创建有效的Long Lived Access Token

使用教程

使用依赖

1. 已安装的Home Assistant实例
2. Claude Desktop环境

安装教程

1. 安装home-assistant-model-context-protocol自定义组件到Home Assistant实例
2. 创建Long Lived Access Token
3. 克隆该git仓库到本地路径
4. 编辑claude_desktop_config.json文件，配置Home Assistant的WebSocket URL和API Token

调试方式

1. 查看日志文件: ~Library/Logs/Claude/mcp-server-Home-assistant.log
2. 使用-v参数增加日志详细程度

许可证

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