Google Home 开发者 MCP 服务器

Google Home 开发者 Model Context Protocol (MCP) 服务器让 AI 驱动的开发工具能够搜索以下内容并检索实时、特定于领域的信息：

它有助于确保 AI 智能体和工具能够提供与 Google Home 开发者计划和技术相关的准确技术答案。

MCP 服务器充当外部服务（提供上下文或数据）与 AI 应用（主机）之间的代理。Home 开发者 MCP 服务器公开了可执行工具，让大语言模型 (LLM) 能够直接从已编入索引的语料库中找到准确的答案。如需详细了解 MCP 服务器，请参阅 MCP 是什么？它是如何运作的？。

前提条件

如需使用 Home 开发者 MCP 服务器，您必须安装与 MCP 兼容的 AI 客户端或编辑器。

Google Antigravity

如果您使用的是 Google 的 AI 开发环境，请安装以下其中一项：

第三方 AI 助理

您还可以将 MCP 与其他 AI 应用、命令行工具和代码编辑器集成，例如：

  • Claude Code
  • 光标
  • GitHub Copilot (VS Code)

选择身份验证路径

您可以根据集成要求，使用未经身份验证的试用路径或经过身份验证的 API 密钥连接到 Home 开发者 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. 在名称 字段中，为密钥提供名称。

    4. 点击选择 API 限制 下拉列表，然后输入 Home Developers API 。点击结果，然后点击确定 。

    5. 点击创建 。

    6. 创建密钥后，点击显示密钥 以查看密钥，并复制密钥以用于下一步。

配置客户端

有多种开发环境可以使用未经身份验证的配置或身份验证配置连接到 Home 开发者 MCP 服务器。请参阅每个环境的说明来设置服务器。

Enter your API key: YOUR_API_KEY

Antigravity

打开本地 ~/.gemini/config/mcp_config.json 配置文件，然后在 mcpServers 对象下添加 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/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 （或您选择的服务器名称键）显示在有效连接列表中。

    确认住宅开发者

  4. 向 Google Home 提出问题，例如：

    How do I create an Automation using Home APIs?

  5. 如果 Antigravity 认为阅读 Google Home 开发者文档会有所帮助，它会请求使用 Home 开发者 MCP 服务器的 search_documents 工具的权限。选择任意允许 选项以继续。

    授予权限

  6. 调用该工具并进行思考后，Antigravity 会根据实际情况回答您的查询。

    Antigravity 回答

视频教程

观看视频，了解安装 Home 开发者 MCP 的分步指南。

直接 HTTP API 测试协议 (c网址)

对于客户端封装容器环境之外的流水线测试，可以通过 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 的想法和建议，或您认为我们如何改进该工具的使用体验。

将您的反馈意见发送给我们