MCP 进 Home Assistant 深度拆解本地大模型操控全屋设备这条路到底走得通吗【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core2026 年以来智能家居圈最热的话题莫过于AI 大脑之争一边是小米等厂商把大模型塞进云端试图用统一大脑接管全屋设备另一边Home Assistant下称 HA选择了一条更反主流的路——把业界标准 Model Context ProtocolMCP直接搬进开源家庭中枢让任何本地大模型都能通过标准化协议读取设备状态、下发控制动作。官方 2026.10 版本已把 MCP 集成作为 AI 能力重点推出。本文不打算停留在能装能用的教程层面而是直接从 HA 源码出发拆清楚三件事MCP 在 HA 里的真实架构是怎样的、权限边界与误操作风险如何被工程化地兜住、以及它和小米大模型大脑的云端路线相比谁更接近智能家居的本质。MCP 在 HA 里到底是怎么长进去的很多人以为 MCP 集成只是加一个连接器但翻开 HA 的源码会发现它的设计远比想象中严谨。整个集成位于 homeassistant/components/mcp/核心思路是把远端 MCP 服务器暴露的 Tools 翻译成 HA 自己的 LLM 工具体系让所有接入 HA 的大模型无论是云端 OpenAI 还是本地 Ollama都能无缝调用。关键证据在init.py 中的ModelContextProtocolAPI类API_PROMPT The following tools are available from a remote server named {name}. dataclass(kw_onlyTrue) class ModelContextProtocolAPI(llm.API): coordinator: ModelContextProtocolCoordinator override async def async_get_api_instance( self, llm_context: llm.LLMContext ) - llm.APIInstance: return llm.APIInstance( self, API_PROMPT.format(nameself.name), llm_context, toolsself.coordinator.data, )它通过llm.async_register_api注册进 HA 的 LLM API 注册表见init.py 的async_setup_entry此后任何对话 Agent 都能通过llm.async_get_api按 ID 拿到这个 API 实例。注意toolsself.coordinator.data——工具列表不是实时拉取的而是由协调器缓存。工具发现的轮询 惰性执行双轨设计工具清单的维护在 coordinator.py 中完成。ModelContextProtocolCoordinator继承自 HA 标准的DataUpdateCoordinatorUPDATE_INTERVAL datetime.timedelta(minutes30) TIMEOUT 10每隔 30 分钟协调器调用一次远端服务器的session.list_tools()把返回的工具逐个转换为ModelContextProtocolTool并缓存。转换过程有一个容易被忽略的细节——远端 MCP 的 JSON Schema 输入参数会通过from_openapi转成 HA 自家的probatio.Schema确保工具参数在进入模型上下文前就经过了本地校验体系。而真正执行工具时走的是另一条路ModelContextProtocolTool.async_call每次调用都现场建立一条新的 MCP 连接而不是用 30 分钟前的缓存async def async_call( self, hass: HomeAssistant, tool_input: llm.ToolInput, llm_context: llm.LLMContext ) - llm.ToolResult: try: async with asyncio.timeout(TIMEOUT): async with mcp_client(hass, self.server_url, self.token_manager) as ( session, _, ): result await session.call_tool( tool_input.tool_name, tool_input.tool_args )这意味着两件事一是工具长什么样每半小时同步一次工具干不干活则每次实时直连远端两者解耦既避免频繁握手、又保证动作实时生效二是每次工具调用都有 10 秒硬超时兜底模型再磨蹭、远端再卡顿也不会把 HA 的事件循环拖死。传输层的优雅降级先 HTTP再 SSEmcp_client的实现coordinator.py同样讲究默认走 MCP 最新的 Streamable HTTP 传输streamable_http_client一旦握手返回 405 Method Not Allowed自动降级到传统的 SSE 传输sse_client并且手写了一个独立的 httpx 客户端_create_sse_httpx_client——注释里写明这是为了避免 SDK 默认客户端在事件循环内读磁盘 CA bundle 造成阻塞。这种协议栈内自适应的细节是 HA 集成一贯的工程水准。模型如何看见并操控全屋设备完整链路还原很多用户困惑本地模型凭什么能控制我家灯光答案藏在 HA 的对话流水线里。以 conversation/chat_log.py 中的async_provide_llm_data为入口Agent 通过llm.async_get_api拿到APIInstance内含工具列表和提示词随后 ollama/entity.py 这类本地模型实体把llm_api.tools逐个序列化为模型可读的 function calling 定义_format_tool函数连同系统提示一起发给本地模型。链路全貌如下用户语音/文本 → conversation Agentdefault_agent / chat_log → llm.async_get_api → ModelContextProtocolAPI.async_get_api_instance → APIInstancetools coordinator 缓存的远端工具 → 本地模型Ollama生成 tool_call → APIInstance.async_call_tool → ModelContextProtocolTool.async_call → mcp_client 实时连接远端 → session.call_tool → 返回 ToolResult → 模型基于结果继续作答关键点在于HA 的 Assist/Home Assistant 原生 LLM 工具如 GetLiveContext与 MCP 远端工具对模型来说是无差别的一等公民。HA 自家读取设备状态的GetLiveContextTool定义在 homeassistant/components/homeassistant/llm.py它返回的是暴露给该 assistant 的实体的实时状态通过async_get_exposed_entities并支持按名称、区域、域过滤而 MCP 工具则把远端服务器能干什么完整交给模型。两者叠加模型既能通过 HA 原生工具理解家里设备的本地语义又能通过 MCP 工具调用外部服务——这正是本地大模型操控全屋的技术底座。权限边界与误操作风险源码里藏着一套防御体系本地模型直接控制物理设备最大的担忧是一句话把家拆了。HA 在架构上做了四层防御全部可以在源码里找到实锤。第一层工具注解的最坏情况默认值helpers/llm.py 中ToolAnnotations的默认值设计非常反直觉但极其稳妥dataclass(frozenTrue, slotsTrue, kw_onlyTrue) class ToolAnnotations: Properties describing how a tool behaves. The defaults describe the least safe case, so a tool that declares nothing is taken to write, to be destructive, and to reach outside Home Assistant. read_only: bool False destructive: bool True idempotent: bool False open_world: bool True凡是远端 MCP 服务器没有显式声明的工具HA 一律按可写、破坏性、非幂等、开放世界处理。这直接决定了模型在决策时看到的工具属性也为 UI 层做二次确认、为安全策略做降权提供了依据。ModelContextProtocolTool在构建时会把远端声明的 readOnlyHint / destructiveHint / idempotentHint / openWorldHint 逐一映射到本地注解见_tool_annotations函数映射不到的就保持保守默认——宁可多怀疑不可少设防。第二层OAuth 全链路与令牌生命周期MCP 服务器的鉴权不是弱密码而是完整的 OAuth 2.0。看 config_flow.py 会发现 HA 实现了一整套协议发现逻辑按 RFC 9728 解析WWW-Authenticate头里的resource_metadata与scope按 RFC 8414 做oauth-authorization-server元数据发现再按 MCP 规范的优先级选择 scope先取认证头声明的 scope再取资源元数据最后取 OAuth 发现结果。令牌刷新失败时async_call里会主动触发config_entry.async_start_reauth拉起重新授权流程coordinator.py 中OAuth2TokenRequestReauthError与 401 的处理分支。也就是说远端工具的每一次调用都带着合法的 Bearer 令牌令牌过期会自动进入重新授权不存在配置一次、裸奔终身的漏洞窗口。第三层API 级别的能力分野HA 把 LLM API 分成两个性质完全不同的类别见 llm/init.pyAssistAPI的注释写明its scope is bounded by entity exposure——只能操作用户显式暴露给语音助手的实体而HomeAssistantAPI管理的是 HA 自身注册表、配置项、系统日志requires_adminTrue仅限管理员。MCP API 作为注册表中的独立 API 既不天然继承 Assist 的实体暴露边界、也不默认要求管理员——这意味着用户配置 MCP 集成时实际上是在显式地把远端服务器的工具集授权给对话模型这是一种知情授权而非默认放权。第四层实体暴露机制收口读的边界即使 MCP 能调远端工具HA 本地的设备状态读取也严格受暴露机制约束async_get_exposed_entities只收集async_should_expose判定为对当前 assistant 可见的实体GetLiveContextTool的注解明确标为read_onlyTrue, open_worldFalse只读、不开放世界。模型能看见什么、能读到什么始终是用户可配置、可收口的而不是默认全量。与云端大模型大脑的路线之争本质是控制权归谁社区情报里有一条值得玩味的新闻线索小米给智能家居做了个大模型大脑试图用云端大模型统一调度全屋设备。这与 HA 的 MCP 路线形成了鲜明的路线对撞。云端大脑路线的逻辑是设备厂商把语义理解、决策推理集中在云端用户获得开箱即用的对话体验代价是控制链路变长、隐私数据上云、以及被锁定在厂商生态。而 HA MCP 路线把同样的能力下放到家庭网关模型可以是本地 Ollama 实例工具协议是开放标准远端服务器可以是自家部署的任意服务。从源码角度看两条路线有一个本质差异在 HA 的架构里模型的能力边界是由本地代码ToolAnnotations、实体暴露、OAuth scope强制约束的而在云端大脑架构里这些边界存在于厂商的服务条款里。HA 的每一个权限决策都是可审计、可修改、可本地化的——mcp组件仅依赖一个mcp1.28.1的 Python 包见 manifest.json其余全部是 HA 自家基础设施这在供应链层面也意味着更少的外部黑盒。当然HA 路线并非没有代价30 分钟的工具清单轮询、每次调用的新建连接、本地模型相对云端模型的理解力差距都意味着 HA MCP 在开箱即用上短期内无法媲美小米大脑的消费级体验。但这恰恰是两条路线的分野——小米卖的是结果一句话控制全屋HA 卖的是过程每一步都看得见、管得住。结论这条路走得通但门槛在工程细节里综合源码证据MCP 进 Home Assistant 不是一次噱头级的集成工具发现与执行的双轨设计、协议栈的自动降级、OAuth 全链路鉴权、以最坏情况默认值为起点的工具注解体系、实体暴露收口……这些工程细节共同回答了开篇的问题——本地大模型操控全屋设备技术上完全走得通而且 HA 已经把误操作风险当作一等公民来处理。真正决定这条路能走多远的反而不是协议本身而是两个变量本地模型的工具调用稳定性模型会不会在关键时刻幻觉出一个不存在的工具参数和远端 MCP 服务器生态的成熟度有没有足够多的、声明了正确注解的服务器可供接入。协议已经铺好接下来看生态。对于普通玩家结论可以很直接如果你追求一句话控制全屋的省心体验云端大脑仍然是最短路径但如果你在乎隐私、可审计性和我的家我做主的控制权HA MCP 这条看似更折腾的路恰恰是唯一把控制权完整留在本地的那条。【免费下载链接】core:house_with_garden: Open source home automation that puts local control and privacy first.项目地址: https://gitcode.com/GitHub_Trending/co/core创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考