homeassistant-ai/ha-mcp

本页介绍外部开源仓库，并非 HDATF 产品。

它做什么

HA-MCP通过用于描述和调用应用工具的MCP通信协议，向AI客户端提供Home Assistant管理能力。AI客户端把用户请求转换为结构化工具参数，服务器再从连接的Home Assistant实例返回设备状态、历史记录、配置资料或操作结果。工具注册表不仅包含设备控制，也包含自动化、脚本和仪表板编辑，以及基于日志和执行轨迹的诊断。已检查的服务器代码在FastMCP工具层加入可见性过滤、可选的搜索式工具发现和逐次调用检查，而不是仅依赖提醒模型谨慎操作。推荐方式是在Home Assistant内部运行集成，文档中的服务器设置要求兼容的Home Assistant 2026.8.0或更高版本，以及管理员账户的访问凭据。本地和远程连接的设置不同，秘密连接URL本身可能就是凭据，因此必须保护。只读连接会隐藏并阻止写操作，但同一凭据仍能访问普通端点，所以这种模式不是凭据级别的独立权限边界。直接文件和YAML编辑属于需要主动开启的测试功能，备份与配置检查不能消除语义错误，也不能替代独立恢复通道。服务器本地运行不代表AI处理一定本地完成，因为选用的MCP客户端会按自己的隐私政策处理Home Assistant资料。它是Home Assistant管理工具，不能据此证明兼容工业控制系统，也不保证生成的自动化安全。

许可证

MIT 宽松许可。保留版权声明即可商用和修改。

同领域的其他仓库

• Ebony-Vinyl/EAC-Desktop
  EAC-Desktop是将DeepSeek Harness组织为桌面工作空间的应用。它面向希望围绕项目文件夹进行对话、文件操作、工具执行和插件管理的用户。输入任务请求、项目文件和模型配置后，Harness执行对话与工具，界面展示文件变更和结果。文档将系统分为三层：Tauri负责窗口和托盘，Node sidecar负责编排启动与环境，Harness内核负责代理执行。所述功能包括检查和还原文件变更、压缩对话、配置模型及管理插件的入口。发行包准备运行时资源，但模型调用仍依赖配置的供应商，插件启用状态和附加依赖因包而异。已检查的环境适配器调用DPX的环境创建、路径和运行时变量API，按发行通道分开默认数据位置。这不是文件系统沙箱，绝对路径访问仍受操作系统权限约束，第三方组件的许可证也需分别核实。
• metadist/synaplan-desktop
  Synaplan Desktop将用户电脑连接到Synaplan工作空间，让聊天请求能够触发本地文件工作。它接收请求、获准访问的文件和已安装的Agent Skills，生成报告、表格、日历文件和未发送邮件草稿等本地产物。客户端基于Tauri和Vue，通过设备配对API及兼容Anthropic的Messages网关与服务器通信。权限受限的配对密钥通常保存在操作系统的机密存储中。本地执行使用获准的解释器和结构化程序参数，拒绝Shell、网络命令工具和内联代码执行。需要无限制Shell或网络访问的技能无法原样运行，Python等依赖工具也必须事先具备。README将其定位为Windows、macOS和Linux上的未签名预览版，尚未发布签名的公开安装包。源码还显示Windows超时处理只终止直接子进程，并不保证终止后代进程，因此隔离保证需要另行验证。
• skaft-software/octet
  octet是面向开发者的终端编程智能体，适合希望用Rust原生运行环境连接云端或本地模型的人。它接收请求、源文件和可选媒体，返回回答、文件修改和命令执行结果。单个进程管理智能体循环、会话、权限策略、持久化和终端界面。工具可通过子进程扩展添加，MCP和子智能体属于可选集成。首个Pi兼容版本支持Pi扩展生态的部分能力，但存在文档列出的缺口，也不会导入任意Pi对话记录。会话使用逐行追加JSON的JSONL记录保存分支和检查点，不会自动重放中断的修改操作。使用前需要准备模型凭据以及所选提供商或本地模型，Windows支持仍处于预览阶段。默认具有操作系统权限下的完整访问能力，基于审批的安全模式并不是隔离命令或受信任扩展的沙箱。
• darkmatter/nixmac
  nixmac是一个macOS配置管理工具，在Nix和nix-darwin设置前加入AI代理。它面向希望用自然语言请求安装软件包或调整系统设置，而不直接编辑Nix文件的Mac用户。输入自然语言请求和现有配置后，会生成修改文件与变更摘要，再通过独立的应用路径激活新系统配置。代理读取文件、搜索软件包和文档、修改文件，并根据检查结果继续修正。检查的实现会在修改阶段使用不执行完整软件包构建的Nix预检查，因此应与README简化的构建描述区分。应用路径以普通用户权限实际构建，然后用管理员权限激活得到的系统。Git历史和保存的系统路径支持审阅与恢复，但文件恢复和系统重新激活是两个操作。文档要求具备Nix flakes、nix-darwin配置及devenv的macOS环境，模型通过OpenRouter、OpenAI兼容端点或Ollama连接。预检查成功不能证明激活成功或符合用户意图，独立的审阅按钮本身也不能证明后端强制执行审批边界。
• agentclientprotocol/codex-acp
  这是把Codex连接到支持ACP的编辑器和客户端的适配器。它是转换请求和执行事件的协议服务器，不是独立语言模型或完整开发环境。它接收文本、图像和工作目录信息，启动Codex App Server，并返回回复、工具事件、文件修改和权限请求。客户端可以选择模型、推理强度、沙箱模式和允许使用的用户权限配置。原生子代理会话及部分执行中输入功能需要与客户端协商能力。npm包包含兼容的Codex依赖，但仍需单独准备客户端启动配置和Codex认证。认证支持ChatGPT登录、API密钥及经过能力协商的自定义网关。安装并不会自动连接所有编辑器或建立安全审批策略，部分权限配置字段仍采用实验性协议。

只收录进入 Trendshift 排行榜的仓库，榜单仅用于寻找候选项目，不转载名次。说明、许可证和星标数来自各 GitHub 仓库。解读是我们自己的判断。我们尚未测试这些项目，上榜并不证明质量。