Hubitat 本地 MCP 服务器

关键词

Hubitat自动化远程控制设备管理规则引擎

使用说明（Markdown 格式）

  • 项目简介

    • 该仓库实现一个本地 MCP 服务，运行在 Hubitat hub 上，面向像 Claude 这样的大语言模型客户端，提供标准化的资源、工具和提示模板服务，并通过 JSON-RPC 与客户端通信。目标是将 Hubitat 的设备、规则、状态等上下文数据以统一的 MCP 方式暴露给 AI 客户端，从而实现更智能的自控与对话式运作。

  • 主要功能点

    • MCP 核心能力：资源（Resources）管理，数据访问能力；工具（Tools）注册/执行，外部功能调用；提示模板（Prompts）定义与渲染，支持自定义的交互模式。
    • 与客户端的通信：基于 MCP 规范的 JSON-RPC 请求/响应处理，支持会话管理与能力声明。
    • 服务暴露与访问：在 Hubitat 本地端/云端提供端点，支持多种传输方式和安全认证配置（如 Hub Security）。
    • 安装与部署：作为 Hubitat 应用形式运行，提供两种安装方式（HPM 自动安装或手动导入父/子应用），避免在外部机器部署。
    • 管理与运维：工具集涵盖大量设备/房间/规则/系统等方面的操作，具备调试日志、备份、诊断等辅助能力。

  • 安装步骤

    • 选项 A：Hubitat Package Manager (HPM)
      • 打开 HPM，添加自定义仓库 URL：https://raw.githubusercontent.com/kingpanther13/Hubitat-local-MCP-server/main/repository.json
      • 通过关键词搜索“MCP Rule Server”并安装，HPM 会同时安装父应用和子应用。
    • 选项 B：手动安装
      • 安装父应用（MCP Rule Server）：在 Hubitat UI 的 Apps Code 中通过导入 URL https://raw.githubusercontent.com/kingpanther13/Hubitat-local-MCP-server/main/hubitat-mcp-server.groovy
      • 安装子应用（MCP Rule）：在 Apps Code 中导入 URL https://raw.githubusercontent.com/kingpanther13/Hubitat-local-MCP-server/main/hubitat-mcp-rule.groovy
      • 完成后启用 OAuth（Parent App）以获取访问令牌，并在应用界面查看生成的本地/云端端点。

  • 服务器配置（MCP 客户端需要的连接信息） 注：MCP 客户端通常通过端点 URL 直接连接本 MCP 服务器（Hubitat 应用内运行，无外部启动命令）。下面给出一份用于理解的配置描述。实际连接以客户端的端点地址为准（本地地址或云端地址，通常由应用 UI 提供）。 server_name: "Hubitat Local MCP Server" command: "N/A – Hubitat 应用在设备端运行，无独立启动命令" args: [] 备注：由于本 MCP 服务器是以 Hubitat 应用形式运行在本地设备上，客户端无需外部启动命令，只需使用应用提供的本地端点地址（本地网络或云端端点）进行连接。

  • 基本使用方法

    • 连接与调用
      • 启动后，在 Claude/其他支持 MCP 的客户端中配置服务器端点（本地或云端）并开始发送 MCP 请求，例如读取资源、执行工具、获取 Prompt 等。
    • 常用场景
      • 查询 hub 状态、获取设备信息、执行规则、触发自动化、获取/渲染 Prompt 模板等。
    • 调试与维护
      • 使用 MCP 提供的调试日志工具查看执行诊断，必要时在 Hubitat 端开启调试日志等级。

服务器信息

访问项目