Google Home 開發人員 MCP 伺服器

Google Home 開發人員 Model Context Protocol (MCP) 伺服器可讓 AI 輔助開發工具搜尋下列項目，並擷取即時的特定領域資訊：

確保 AI 代理程式和工具能提供與 Google Home 開發人員計畫和技術相關的準確技術答案。

MCP 伺服器可做為外部服務 (提供脈絡或資料) 與 AI 應用程式 (主機) 之間的 Proxy。Home Developer MCP 伺服器會公開可執行的工具，讓大型語言模型 (LLM) 直接從已建立索引的語料庫中找出確切答案。如要進一步瞭解 MCP 伺服器，請參閱「什麼是 MCP，運作方式為何？」。

必要條件

如要使用 Home Developer MCP 伺服器，必須安裝與 MCP 相容的 AI 用戶端或編輯器。

Google Antigravity

如果您使用 Google 的 AI 開發環境，請安裝下列其中一項：

第三方 AI 助理

您也可以將 MCP 與其他 AI 應用程式、指令列工具和程式碼編輯器整合，例如：

  • Claude Code
  • Cursor
  • GitHub Copilot (VS Code)

選擇驗證路徑

您可以根據整合需求，使用未經驗證的試用路徑或經過驗證的 API 金鑰，連線至 Home Developer MCP 伺服器。

未經驗證的連線測試

這個方法不需要任何 API 金鑰或 Google Cloud 設定。這個伺服器使用共用的公開配額，因此是試用伺服器和立即測試核心機制的最佳方式。

正式版驗證連線

為避免共用公開配額受到速率限制，建議您驗證環境，以利持續開發。

如要完成這項路徑，您必須有有效的 Google Cloud 專案。

  1. 在 Google Cloud 控制台中，為專案啟用 API：
    1. 在 Google API 程式庫中開啟 Home Developers API 頁面。
    2. 確認您已選取要使用 API 的正確專案。
    3. 按一下「啟用」。

  2. 建立 API 金鑰：

    1. 前往「憑證」頁面。
    2. 按一下「建立」憑證，然後從選單中選取「API 金鑰」。
    3. 在「Name」(名稱) 欄位中，輸入金鑰名稱。

    4. 按一下「選取 API 限制」下拉式選單，然後輸入「Home Developers API」。按一下結果，然後按一下「確定」。

    5. 點選「建立」。

    6. 建立金鑰後，按一下「顯示金鑰」即可查看，並複製金鑰以進行下一個步驟。

設定用戶端

有多種開發環境可透過未經驗證或驗證設定，連線至 Home Developer MCP 伺服器。請參閱各環境的操作說明，設定伺服器。

Enter your API key: YOUR_API_KEY

Antigravity

開啟本機 ~/.gemini/config/mcp_config.json 設定檔，然後在 mcpServers 物件下方新增「HomeDevelopers」HomeDevelopers項目。

無論您使用 Antigravity CLI、Antigravity 2.0 或 Antigravity IDE，這些工具都會共用位於 ~/.gemini/config/mcp_config.json 的設定檔。您在這個檔案中定義的任何變更或伺服器對應，都會自動套用至所有三個環境。

未通過驗證

{
  "mcpServers": {
    "HomeDevelopers": {
      "serverUrl": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

已驗證

{
 "mcpServers": {
    "HomeDevelopers": {
      "serverUrl": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Claude

如要設定 Claude Code，請在應用程式目錄下執行指令。

未通過驗證

claude mcp add HomeDevelopers --transport http https://homedevelopers.googleapis.com/mcp

已驗證

claude mcp add HomeDevelopers --transport http https://homedevelopers.googleapis.com/mcp --header "X-Goog-Api-Key: "YOUR_API_KEY"

Cursor

如要設定 Cursor，請編輯 .cursor/mcp.json (特定專案) 或 ~/.cursor/mcp.json (所有專案)。

未通過驗證

{
  "mcpServers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

已驗證

{
  "mcpServers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

GitHub Copilot

如要為單一專案在 VS Code 中設定 GitHub Copilot，請編輯工作區中的 .vscode/mcp.json 檔案。或者，如要讓伺服器全域可用，請按一下開啟設定 (JSON) 按鈕，然後在使用者設定中新增「mcp」根鍵下方的 JSON。

未通過驗證

{
  "servers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

已驗證

{
  "servers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

驗證安裝和執行作業

更新工具設定後，請提示代理程式工作區，驗證連線。

驗證範例 (Antigravity CLI)

  1. 啟動互動式工作區工作階段：

    agy

    啟動工作區工作階段

  2. 執行探索檢查清單巨集，檢查作用中的 MCP 伺服器：

    /mcp

  3. 確認「HomeDevelopers」HomeDevelopers (或您選擇的伺服器名稱金鑰) 出現在有效連線清單中。

    確認住家開發人員

  4. 向 Google Home 詢問問題，例如：

    How do I create an Automation using Home APIs?

  5. 如果 Antigravity 認為閱讀 Google Home 開發人員說明文件有助於解決問題，就會要求使用 Home 開發人員 MCP 伺服器的 search_documents 工具。選取任一「允許」選項即可繼續。

    授予權限

  6. 呼叫工具並思考後，Antigravity 會根據實際情況回答你的問題。

    Antigravity 回覆

教學影片

如需逐步安裝指南，請觀看這部影片。

直接 HTTP API 測試通訊協定 (cURL)

如要在用戶端包裝函式環境以外測試管道，可以透過 curl 管道傳送標準 JSON-RPC 酬載。

探索有效的系統工具

curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
}'

執行功能搜尋查詢

未經驗證

curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "id": 2,
    "params": {
        "name": "search_documents",
        "arguments": {
            "query": "How to create an automation?"
        }
    }
}'

已驗證

curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--header 'Accept: application/json, text/event-stream' \
--header "X-Goog-Api-Key: "YOUR_API_KEY" \
--data '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "id": 2,
    "params": {
        "name": "search_documents",
        "arguments": {
            "query": "How to create an automation?"
        }
    }
}'

提供意見

請填寫意見回饋表單，將您對 Home 應用程式開發人員 MCP 的想法和建議，或是如何改善工具使用體驗告訴我們。

郵寄您的意見給我們