Home-MCP

Home-MCP 是一个基于 Model Context Protocol (MCP) 的开源智能家居集成服务器，专为 AI 助手提供标准化的 Home Assistant 设备控制接口。通过语义化的 API 和完整的 Home Assistant 功能覆盖，让 AI 能够自然地理解和控制智能家居设备。

✨ 核心特性

🤖 AI 优先设计

• 语义化控制: 通过自然语言描述的 API，让 AI 更容易理解和使用
• 智能设备匹配: 支持模糊匹配设备名称，提供更自然的交互体验
• 标准化协议: 基于 MCP 协议，与各种 AI 助手无缝集成

🏠 完整的 Home Assistant 集成

• 全面 API 覆盖: 支持设备控制、状态查询、历史数据、日志查看等 20+ 工具
• 实时状态同步: 获取设备的实时状态和历史变化数据
• 安全认证: 支持长期访问令牌，确保连接安全

🔧 开发者友好

• 类型安全: 完整的 TypeScript 类型定义和运行时验证
• 易于扩展: 模块化架构，支持自定义工具开发
• 详细文档: 完善的使用文档和示例代码

🚀 快速体验

{
  "mcpServers": {
    "home-mcp": {
      "command": "npx",
      "args": ["-y", "home-mcp@latest"],
      "env": {
        "HA_TOKEN": "你的长期访问令牌",
        "HA_BASE_URL": "你的Home Assistant 地址，一般是 http://localhost:8123"
      }
    }
  }
}

用户: 帮我把书房的灯调到80%亮度
Claude: 好的，我来帮您调节书房灯光。

npx home-mcp

export HA_TOKEN="你的长期访问令牌"
export HA_BASE_URL="http://localhost:8123"

💡 使用场景

🏡 家庭用户

通过 AI 助手用自然语言控制家居设备：

# 语音控制示例
"把客厅的灯调暗一点"
"打开卧室的空调到26度"
"查看家里的温度和湿度"

📖 文档导航

• 快速上手 - 详细的安装和配置指南
• 使用场景 - 更多实际应用案例
• 配置指南 - 完整的配置选项说明
• MCP工具 - 所有可用工具的详细文档

🤝 社区支持

• GitHub: shenjingnan/home-mcp 
• 问题反馈: Issues 
• 贡献指南: 查看 开发文档