Google Home 开发者 MCP 服务器

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

• Google Home 开发者中心公共文档
• OpenThread
• Matter 规范：适用于版本 1.5.1
• Thread 规范：适用于版本 1.4.1

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

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

前提条件

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

Google Antigravity

如果您使用的是 Google 的 AI 开发环境，请安装以下任一工具：

• Antigravity CLI，并遵循开始使用 Antigravity CLI 指南
• Antigravity 2.0，遵循 Google Antigravity 文档
• Antigravity IDE，按照 Antigravity IDE 使用入门指南操作

第三方 AI 助理

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

• Claude Code
• 光标
• VS Code 中的 GitHub Copilot

选择身份验证路径

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

   4. 点击选择 API 限制 下拉菜单，然后输入 Home Developers API。点击相应结果，然后点击确定。

   5. 点击创建。

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

配置客户端

在以下字段中输入您的凭据，以填充首选 AI 开发环境的配置模板：

Enter your API key: YOUR_API_KEY

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

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

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

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

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

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

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

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

验证安装和执行

更新工具配置后，通过提示代理工作区来验证连接。

Antigravity CLI 中的验证示例

1. 启动交互式工作区会话：

   agy
   

   

2. 执行发现清单命令以检查活跃的 MCP 服务器：

   /mcp
   

3. 确认 HomeDevelopers（或您选择的服务器名称密钥）显示在有效连接列表中。

   

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

   How do I create an Automation using Home APIs?
   

5. 当 Antigravity 请求调用 Home Developer MCP 服务器的 search_documents 工具的权限时，选择任意允许选项以继续。

   

6. 调用该工具后，Antigravity 会根据文档中的信息回答您的查询。

   

视频教程

观看此视频，了解有关安装 Home Developer MCP 的分步指南。

使用直接 HTTP curl 请求进行测试

如需在 AI 客户端环境之外测试流水线，您可以使用 curl 将标准 JSON-RPC 2.0 载荷直接发送到 https://homedevelopers.googleapis.com/mcp。

探索有效的系统工具

使用 tools/list 方法检查服务器公开的工具：

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

执行功能搜索查询

选择一个标签页，以使用 API 密钥或未经身份验证的请求来测试 search_documents：

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?"
          }
      }
  }'

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

发送反馈

您可以使用我们的反馈表单提交有关 Home Developer MCP 的想法和建议，或提出有关如何改进该工具的建议。

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