Google Home MCP 伺服器

   搶先體驗   

Google Home Model Context Protocol (MCP) 伺服器可讓 AI 輔助開發工具和虛擬助理直接與智慧住宅環境互動。透過公開標準 MCP 工具和 RPC 介面，伺服器可讓大型語言模型 (LLM) 檢查住家結構、監控裝置狀態、執行控制動作，以及分析歷來事件。

警告！

將真實住家連結至 AI 代理後，該代理就能代為控制裝置。住家 MCP 會強制執行速率限制和安全防護措施，例如禁止解鎖門鎖等敏感動作。不過，視代理程式而定，將其連線至 Home MCP 可能會導致非預期或不當行為。詳閱開發人員政策和服務條款。

如果選擇將其他家庭成員使用的 Google Home 連結至居家 MCP，請告知對方服務專員可以控制裝置及存取住家資料。或者，您也可以建立其他住家，並設定用於開發和測試的裝置。

你隨時可以透過 Google Home app (GHA) 或「我的帳戶」頁面撤銷服務專員的 Home MCP 存取權。

總覽

MCP 伺服器是智慧住宅基礎架構與 AI 應用程式之間的 Proxy。Home MCP 伺服器會公開可執行的工具，讓 AI 用戶端查詢即時居家遙測資料並發出指令。

核心功能

Home MCP 伺服器提供多個核心功能領域：

  • 結構探索：使用 list_homes 擷取可存取的住家和結構。
  • 資源探索：使用 list_home_resources 列出裝置、區域版面配置、特徵、屬性和指令結構定義。
  • 狀態監控：使用 list_home_states 查看裝置連線狀態和特徵狀態。
  • 裝置控制：使用 run_home_actions 在目標裝置上執行參數化動作指令。
  • 歷史記錄分析：使用 list_home_history 查詢特定時間範圍內的過去狀態變化和事件記錄。

必要條件

設定 Home 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. 將「應用程式類型」設為「網頁應用程式」。
    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 >「Audience」。
    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 Connectors。
  2. 按一下「+」，然後選取「新增自訂連接器」。
  3. 輸入伺服器網址： https://home.googleapis.com/mcp。
  4. 按一下「進階設定」，然後輸入「用戶端 ID」和「用戶端密鑰」。
  5. 按一下「新增」，並在瀏覽器中完成 OAuth 授權流程。
  6. 在 Cowork 聊天室中，按一下左下角的「+」，選取「連結器」，然後開啟「home_mcp」。

詳情請參閱 Claude Platform 說明文件。

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。如要取得這項資訊，最簡單的方法是使用 Home MCP 詢問服務專員：「Tell me the structure ID (UUID) for [結構名稱]」(告訴我「[結構名稱]」的結構 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 錯誤或提出功能要求，請前往公開的 Issue Tracker。

已知問題

  • 特徵測試：為提供最廣泛的代理程式功能，我們納入了一些標示為實驗性的特徵。您可能會遇到這些實驗性特徵無法正常運作的情況。如有，請使用公開 Issue Tracker 回報。
  • 延遲時間 - 有時您可能會發現 Home MCP 的延遲時間比預期長。我們正在積極進行最佳化作業。我們預計在日後版本中改善延遲問題。

即將推出

  • 自動化動作 - 目前不支援使用 Home MCP 建立及管理自動化動作。我們正在開發這項功能，預計在日後推出的版本中支援自動化。