使用说明
家庭助理MCP服务器
📖 安装指南 --快速启动、手动设置和故障排除
FastMCP 3.2.0 MCP服务器和Web应用程序 家庭助手.Portmanteau工具、采样、代理工作流程、提示和技能。Webapp遵循SOTA标准（React、Tailwind、深色主题、端口10796/10797）。
特性
- MCP工具:
ha(operation=...)get_state、get_state、call_service、get_config、get_automations、trigger_automation。ha_help(category).ha_agentic_workflow(goal)采用SEP-1577采样。 - 提示:
ha_quick_start,ha_diagnostics. - 技能:
skills/ha-operator.md. - REST API：GET/api/v1/health、/api/v1/states、/api/v1.config、/api/v1/automations；POST/api/v1/服务/{域}/{服务}、/api/v1/自动化/触发器。
- 网络应用程序：仪表板、状态（按域筛选）、服务（调用服务表单）、自动化（列表+触发器）、设置、帮助、MCP工具。
港口
- 后端： 10796 （休息+MCP-SSE）
- 仪表板： 10797 （快）
快速开始
git clone https://github.com/sandraschi/home-assistant-mcp
cd home-assistant-mcp
just
这将打开一个交互式仪表板，显示所有可用命令。跑 just bootstrap 要安装依赖项，请执行以下操作 just serve 或 just dev 开始。
手动设置
如果你没有 just 安装：
设置
克隆仓库并从安装依赖项 存储库根目录 （不是 webapp/):
git clone https://github.com/sandraschi/home-assistant-mcp.git
Set-Location home-assistant-mcp
uv sync
从启动Web应用程序 相同 克隆：
cd webapp
.\start.ps1
集 HA_URL （例如。http://homeassistant.local:8123)以及 HA_TOKEN （HA配置文件中的长效访问令牌）。
MCP客户端
{
"mcpServers": {
"home-assistant": {
"url": "http://localhost:10796/sse",
"transport": "sse"
}
}
}
舰队
记录在mcp中央文档中（集成+项目/家庭助理mcp）。
🛡️ 工业级质量堆栈
该项目坚持 索塔14.1 高保真代理编排的工业标准：