用途：把 Home Assistant 接入支持 MCP 的 AI 助手，让助手通过对话控制智能家居设备并读取状态。基于 Python 与 FastMCP 构建，采用异步操作与 TTL 缓存降低 API 负载。
主要能力：提供约 40 个工具，覆盖灯光、温控、窗帘、门锁、媒体播放器、扫地机器人等设备控制，以及状态管理、设备发现、服务调用、自动化/场景/脚本控制、Jinja2 模板渲染、历史与日志查询、日历、摄像头操作。为保持上下文精简，默认只暴露 8 个核心工具，通过 discover_tools() 查看完整目录、search_tools(query=...) 用 BM25 检索、call_tool(tool_name=..., arguments={...}) 调用。MCP 资源以 URI 形式提供只读数据，如 hass://entity/{entity_id}、hass://area/{area_id}、hass://device/{device_id}、hass://services、hass://entity/{entity_id}/history?hours=24。
使用方式：推荐用 uvx 免安装运行，在 MCP 客户端配置 command 为 uvx、args 为 ["homeassistant-mcp"]，并设置环境变量，例如 HASS_HOST="http://homeassistant.local:8123"、HASS_TOKEN="your_long_lived_access_token_here"。也可 pip install homeassistant-mcp 后运行 homeassistant-mcp，或从源码 git clone 后 pip install -e ".[dev]"。可选环境变量包括 CACHE_TTL_STATES（默认 30 秒）、CACHE_TTL_ENTITY（默认 10 秒）、LOG_LEVEL（默认 INFO）。Claude Desktop 配置位于 macOS 的 ~/Library/Application Support/Claude/claude_desktop_config.json 或 Windows 的 %APPDATA%\Claude\claude_desktop_config.json；Cursor 使用 .cursor/mcp.json。
适用场景：晨间例程、安防检查、能耗优化、影音室场景、基于温度或光照的条件控制等家庭自动化流程。
限制：需要 Home Assistant 实例、长期访问令牌及对应设备域权限；连接问题、实体未找到、服务调用失败、缓存与认证等问题需按文档排查；工具数量与具体行为以实际版本为准。官方未在资料中说明收费或价格信息。