Claude Desktop的家庭助理MCP服务器
MCP（模型上下文协议）服务器，用于将家庭助理与Claude Desktop集成。直接从Claude监控智能家居的传感器、统计数据和历史记录。
特性
- 6+阅读工具 -实体状态、实体列表、搜索、统计、历史
- 拖放安装 -拖动
.mcpb文件到克劳德桌面 - 高级统计 -趋势、汇总、历史分析
- 多个版本 -基础版（已准备就绪）、专业版（36+工具）、终极版（190+计划工具）
需求
- 已安装Claude Desktop
- Home Assistant正在运行且可访问
- 家庭助理长期访问令牌
- Node.js 18+（仅用于手动安装）
快速安装
1.获取家庭助理令牌
- 打开家庭助手
- 首选 个人资料 （左下角的图标）
- 滚动到 长寿命访问令牌
- 点击 创建令牌 并将其命名为“克劳德MCP”
- 复制令牌（您将不会再看到它！）
2.安装捆绑包
- 打开克劳德桌面
- 拖拽
homeassistant-mcp-1.0.0.mcpb进窗户 - 输入您的家庭助理URL:
http://homeassistant.local:8123 - 粘贴令牌
- 完成！
3.验证
问克劳德：
"Show me all my Home Assistant sensors"可用版本
Base v1.0-随时可用
文件: homeassistant-mcp-1.0.0.mcpb
- 6阅读工具
- 只读（安全）
- 拖放安装
- 生产就绪
包含的工具:
| 工具 | 说明 |
|---|---|
ha_get_state | 获取当前实体状态 |
ha_list_entities | 使用筛选器列出实体 |
ha_search_entities | 按图案搜索 |
ha_get_statistics | 汇总统计数据 |
ha_get_history | 完整历史 |
ha_get_sensor_summary | 趋势总结 |
Pro v2.0-完全控制
文件: homeassistant-mcp-pro-2.0.0.mcpb
- 36+工具（读+写）
- 设备控制
- 使用ML进行高级分析
- 图表和CSV/PDF导出
- 专门的蜂窝监测
- 需要编译(
npm run build)
终极v3.0-完整套件
文件: homeassistant-mcp-ultimate-3.0.0.mcpb
- 190+计划工具
- 场景管理
- 配备ML的警报系统
- 能量优化器
- 10个高级类别
- 积极发展
使用示例
"What's the temperature in the bedroom?"
"Show hive weight statistics for the last week"
"List all temperature sensors"
"Search entities with 'humidity' in the name"
"Give me the last 24 hours history for sensor.power"时间语法
24h ago-过去24小时7d ago-上周30d ago-上个月
域筛选器
"List all switches"
"Show lights that are on"
"Find binary sensors"手动安装
如果拖放不起作用：
# Extract the bundle
unzip homeassistant-mcp-1.0.0.mcpb -d homeassistant-mcp
cd homeassistant-mcp
npm install配置 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）：
{
"mcpServers": {
"homeassistant": {
"command": "node",
"args": ["/path/to/homeassistant-mcp/dist/index.js"],
"env": {
"HA_URL": "http://homeassistant.local:8123",
"HA_TOKEN": "your_token"
}
}
}
}重新启动克劳德桌面。
文档
QUICK_START.md-1分钟内快速入门指南INSTALLATION.md-详细的安装指南DOCUMENTATION.md-完整的文档CHANGELOG.md-版本历史HomeAssistant-MCP-Docs.zip-完整的文档存档
故障排除
克劳德看不到服务器
- 完全重新启动克劳德桌面
- 签入“设置”>“开发人员”>“MCP服务器”
- 验证URL和令牌
连接错误
验证家庭助理是否可用：
curl -H "Authorization: Bearer YOUR_TOKEN" \
http://homeassistant.local:8123/api/states无效令牌
- 转到家庭助理>个人资料
- 创建新令牌
- 更新配置
- 重新启动克劳德桌面
安全
- 只读的 （Base v1.0）：服务器只能读取数据
- 专用令牌：为此MCP使用单独的令牌
- 可撤销的：您可以随时撤销令牌
- 本地：没有数据发送到外部服务器
项目结构
Claude-Desktop-HA/
├── homeassistant-mcp-1.0.0.mcpb # Base bundle (ready)
├── homeassistant-mcp-pro-2.0.0.mcpb # Pro bundle
├── homeassistant-mcp-ultimate-3.0.0.mcpb # Ultimate bundle
├── HomeAssistant-MCP-Docs.zip # Documentation
├── QUICK_START.md # Quick start
├── INSTALLATION.md # Installation guide
├── DOCUMENTATION.md # Complete docs
├── CHANGELOG.md # Versions
└── README.md # This file兼容性
- 家庭助手2024.x+
- 克劳德桌面：最新
- Node.js: 18+
- MCP-SDK: 1.0.4+
路线图
- \[\]WebSocket实时更新
- \[\]嵌入式HTML仪表板
- \[\]语音命令
- \[\]TensorFlow.js机器学习预测
- \[\]MQTT/Zigbee支持
贡献
- 测试基础v1.0
- 完成Pro v2.0中缺失的工具
- 在Ultimate v3.0中实现新类别
- 改进文档
- 报告错误并建议功能
许可证
MIT许可证-有关详细信息，请参阅许可证。
______________________________________________________________________
为家庭助理与Claude Desktop的集成而创建。