Google Home MCP 服务器

   抢先体验   

Google Home Model Context Protocol (MCP) 服务器可让 AI 赋能的开发工具和虚拟助理直接与智能家居环境互动。通过公开标准 MCP 工具和 RPC 接口，服务器使大语言模型 (LLM) 能够检查住宅结构、监控设备状态、执行控制操作和分析历史事件。

警告！

将现实生活中的住宅与 AI 智能体相关联后，该智能体便可代表您控制设备。Home MCP 会强制执行速率限制和安全保护措施，例如禁止解锁门等敏感操作。不过，根据代理的不同，将其连接到 Home MCP 可能会导致意外行为，甚至是不良行为。仔细查看开发者政策和服务条款。

如果您选择将其他家庭成员使用的 Google Home 与 Home MCP 相关联，则应告知他们您的代理可以控制设备并访问住宅数据。或者，您也可以创建其他住宅并设置设备以进行开发和测试。

您可以随时通过 Google Home app (GHA) 或“我的账号”页面撤消代理对 Home MCP 的访问权限。

概览

MCP 服务器充当智能家居基础设施与 AI 应用之间的代理。Home MCP 服务器公开了可执行的工具，使 AI 客户端能够查询实时住宅遥测数据并发出命令。

核心功能

Home MCP 服务器提供以下几个核心功能领域：

  • 结构发现：使用 list_homes 检索可访问的住宅和结构。
  • 资源发现：使用 list_home_resources 列出设备、区域布局、特征、属性和命令架构。
  • 状态监控：使用 list_home_states 检查实时设备连接状态和特征状态。
  • 设备控制：使用 run_home_actions 在目标设备上执行参数化操作命令。
  • 历史分析：使用 list_home_history 查询特定时间范围内的过往状态变化和事件日志。

前提条件

在设置主 MCP 服务器之前，请确保您已准备好以下各项：

  • Google Home 中已设置智能家居，且已连接设备。
  • 有效的 Google Home Premium Advanced 订阅。
  • 对 Google Cloud 项目的访问权限。
  • 与 MCP 兼容的 AI 客户端或应用，例如 Google Antigravity、Claude Cowork 或 OpenClaw。

配置 MCP 服务器

设置 MCP 服务器需要创建 Google Cloud 项目、获得访问批准、启用 Home API 并生成 OAuth 凭据。

创建 Google Cloud 项目

如果您还没有 Google Cloud，则必须创建一个：

  1. 打开 Google Cloud 控制台。
  2. 创建新的 Google Cloud 项目。

如需了解详情，请参阅 Google Cloud 文档中的创建项目一文。

启用 Home API

  1. 在 Google Cloud 控制台导航菜单中，依次选择 API 和服务 > 已启用的 API 和服务。
  2. 搜索 Home API，然后点击启用。
  1. 配置 OAuth 权限请求页面：
    1. 依次打开 API 和服务 > OAuth 权限请求页面。
    2. 选择外部受众群体，点击开始，然后填写所需的应用信息和联系人邮箱地址。
  2. 创建 OAuth 客户端 ID：
    1. 依次打开 API 和服务 > 凭据。
    2. 点击 + 创建凭据，然后选择 OAuth 客户端 ID。
    3. 将应用类型设置为 Web 应用。
    4. 添加与目标 AI 客户端对应的已获授权的重定向 URI：
      • Google Antigravity： https://antigravity.google/oauth-callback
      • Claude Cowork： https://claude.ai/api/mcp/auth_callback
      • OpenClaw：本地 OpenClaw 安装指定的重定向 URI
    5. 点击创建，然后将您的客户端 ID 和客户端密钥复制到安全的位置。
  3. 发布应用：
    1. 打开 Google Auth Platform > 受众群体。
    2. 在发布状态下，点击发布应用。

配置 AI 客户端

您可以配置多个 AI 开发环境，以使用 OAuth 身份验证连接到 Home MCP 服务器。在此处输入您的 OAuth 客户端 ID 和客户端密钥，然后按照您偏好的设置说明操作。

Enter your Client ID: YOUR_CLIENT_ID
Enter your Client Secret: YOUR_CLIENT_SECRET

使用提示进行自动设置

如果 AI 助理支持直接通过聊天管理 MCP 工具配置，您可以粘贴以下提示，指示助理配置服务器：

Please configure the Home MCP server for me with these settings:
- Name: home_mcp
- Server URL: https://preprod-home.sandbox.googleapis.com/mcp
- Transport: sse
- OAuth Scope: https://www.googleapis.com/auth/home.platform.v2
- Client ID: YOUR_CLIENT_ID
- Client Secret: YOUR_CLIENT_SECRET

手动设置

选择您偏好的 AI 工具，查看手动设置说明。

Antigravity

Google Antigravity 在其 CLI、IDE 和桌面环境中为 MCP 服务器提供内置集成。

  1. 打开应用配置菜单：设置 > 高级设置 > 自定义设置 > 打开 MCP 配置。

  2. 在 mcpServers 配置对象下添加 home_mcp 条目：

    {
  "mcpServers": {
    "home_mcp": {
      "serverUrl": "https://home.googleapis.com/mcp",
      "oauth": {
        "clientId": "YOUR_CLIENT_ID",
        "clientSecret": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

  3. 完成身份验证：依次前往设置 > 高级设置 > 自定义 > home_mcp > 身份验证。

  4. 在网络浏览器中完成 Google Home 权限授予流程，选择住宅结构，然后将授权代码复制回 Antigravity。

如需了解详情，请参阅 Google Antigravity 文档。

Claude

配置 Claude Cowork 以连接到您的自定义家庭 MCP 服务器：

  1. 打开 Claude 连接器。
  2. 点击 +，然后选择添加自定义连接器。
  3. 输入服务器网址：https://home.googleapis.com/mcp。
  4. 点击高级设置，然后输入您的客户端 ID 和客户端密钥。
  5. 点击添加，然后在浏览器中完成 OAuth 授权流程。
  6. 在 Cowork 对话中，点击左下角的 +，选择连接器，然后将 home_mcp 切换为开启状态。

如需了解详情，请参阅 Claude 平台文档。

OpenClaw

配置 OpenClaw 以通过 OAuth 身份验证连接到远程 SSE 传输：

  1. 准备配置补丁 JSON 块：

    {
  "mcp": {
    "servers": {
      "home_mcp": {
        "url": "https://home.googleapis.com/mcp",
        "transport": "sse",
        "auth": "oauth",
        "oauth": {
          "scope": "https://www.googleapis.com/auth/home.platform.v2",
          "redirectUrl": "[YOUR_OPENCLAW_REDIRECT_URL]"
        },
        "env": {
          "CLIENT_ID": "YOUR_CLIENT_ID",
          "CLIENT_SECRET": "YOUR_CLIENT_SECRET"
        }
      }
    }
  }
}

  2. 在终端中应用配置补丁：

    openclaw config patch --stdin

  3. 重启 OpenClaw 网关：

    openclaw gateway restart

  4. 启动身份验证流程：

    openclaw mcp login home_mcp

  5. 按照生成的授权网址登录并授予访问权限。

如需了解详情，请参阅 OpenClaw 文档。

如需在 Home MCP 中访问“熟悉的面孔”数据，用户必须单独明确同意使用此功能。

前提条件

  • 授予同意声明的用户必须是 Google Home 结构的管理员。
  • 用户必须拥有至少一个兼容的 Google Nest摄像头或门铃，并且有效订阅了Google Home Premium 熟面孔检测功能，同时为每个摄像头或门铃启用该功能。
  • 您的应用必须在 Google Cloud 中创建 OAuth 2.0 客户端 ID。如果您尚未创建 OAuth 2.0 客户端，请参阅配置 AI 客户端。

如需授予应用访问权限，您必须访问一个根据您的 OAuth 2.0 客户端 ID 和 Home 结构 ID 个性化定制的同意链接。您可以通过以下两种方式获取同意声明链接。

获得链接后，请访问该链接并提供同意情况。

如果您的代理已连接到 Home MCP，它可以自动找到您的 Home 结构 ID 并生成可直接点击的链接。

直接在此页面上更新以下参数，然后将自定义提示复制并粘贴到代理的对话中。

  • CLIENT_ID - Google Cloud 中的 OAuth 2.0 客户端 ID。例如，`123456789-xyz.apps.googleusercontent.com`。
  • STRUCTURE_NAME - 目标 Home 结构的名称。
Please query my Home MCP to find the
Structure ID for my home named STRUCTURE_NAME. Once found, display
the structure name and ID, generate my clickable Familiar Faces Consent Link by
replacing <STRUCTURE_ID> in this URL with the structure ID you found:
https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=<STRUCTURE_ID>&features=1&continue=https%3A%2F%2Fhome.google.com

如果您的代理已连接到 Home MCP，它可以自动找到您的 Home 结构 ID 并生成可直接点击的链接。

直接在此页面上更新以下参数，然后在网络浏览器中打开自定义链接。

  • CLIENT_ID - Google Cloud 中的 OAuth 2.0 客户端 ID。例如，`123456789-xyz.apps.googleusercontent.com`。
  • STRUCTURE_ID - 目标 Home 结构的 UUID。获取此 ID 的最简单方法是使用 Home MCP 询问您的代理：“告诉我 [结构名称] 的结构 ID (UUID)。”
https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=STRUCTURE_ID&features=1&continue=https%3A%2F%2Fhome.google.com

验证连接和功能

配置并验证客户端后，请验证服务器连接：

  1. 启动 AI 助理或工作区会话。
  2. 检查有效的 MCP 服务器连接（在 Antigravity 中，运行 /mcp 或检查工具列表）。
  3. 确认 home_mcp 列出了有效工具。

  4. 向助理发出示例提示，以测试不同的功能：

    • 实体发现： How many lights do I have in my house?
    • 实时状态监控： Is my home secured?
    • 设备控制： Turn off all the outside lights.
    • 历史事件分析： What happened while I was out?

  5. 在客户端提示时授予工具执行权限。AI 助理可以检索实时状态数据，所有回答都将基于您的住宅遥测数据。

支持

如需有关 Home MCP 开发方面的支持，请前往面向开发者的智能家居帮助社区。您可以在其中发帖提问以寻求帮助，也可以浏览之前发布的帖子，看看您的问题是否已有答案。

如需提交 MCP bug 或功能请求，请前往我们的公开问题跟踪器。

已知问题

  • 特征测试 - 为了让您的代理获得最广泛的功能集，我们添加了一些标记为实验性的特征。您可能会遇到这些实验性特征无法按预期运作的情况。如果确实如此，请使用公开问题跟踪器进行报告。
  • 延迟时间 - 有时，您可能会发现 Home MCP 的延迟时间比预期长。我们正在积极进行优化。我们会在未来的版本中改进延迟问题。

即将推出

  • 自动化操作 - 目前不支持使用 Home MCP 创建和管理自动化操作。我们正在开发此功能，并计划在未来的版本中发布自动化支持。