Google Maps Platform Code Assist 工具包

说明

Google 地图平台 Code Assist 工具包是一个 Model Context Protocol (MCP) 服务器，它通过将回答基于官方最新文档和代码示例，增强了用于开发 Google 地图平台应用的大语言模型 (LLM) 的回答。

由于 MCP 服务器会在模型收到提示时访问内容，因此 LLM 关于 Google 地图平台的上下文不必局限于模型训练日期时的可用数据。

MCP 服务器可以访问的 Google Maps Platform 资源包括：

Google Maps Platform 文档
Google Maps Platform 服务条款
Google Maps Platform 信任中心
Google Maps Platform 官方 GitHub 组织中的代码库

提供的工具

MCP 服务器为 AI 客户端公开了以下工具：

retrieve-instructions：客户端使用的一个辅助工具，用于获取关于如何最好地推断用户意图并制定对 retrieve-google-maps-platform-docs 工具的有效调用的重要系统说明。
retrieve-google-maps-platform-docs：主要工具。它接受自然语言查询，并将其提交给托管的检索增强生成 (RAG) 引擎。RAG 引擎会搜索最新版本的 Google Maps Platform 官方文档、教程和代码示例，并将相关上下文返回给 AI，以生成准确的回答。

支持的 MCP 传输方式

此服务器支持两种标准 MCP 通信协议：

stdio：这是客户端通过 command 调用服务器时使用的默认传输方式。它通过标准输入/输出流进行通信，非常适合本地命令行执行。
Streamable HTTP：服务器公开了一个接受 POST 请求的 /mcp 端点。这是通过 url 连接的客户端使用的，也是远程服务器连接的标准。我们的实现支持流式传输，可提供实时互动式回答。

用法

您可以在本地开发机器上或 Google Cloud Run 上远程运行 Code Assist MCP 服务器。

要求

如需使用 Google 地图平台 Code Assist 工具包，您需要一个安装了 Node.js（建议使用 LTS 版本）和 npm 的环境，以便克隆和运行服务器，还需要一个 MCP 客户端来访问服务器。

将 Code Assist 用作本地 MCP 服务器，并使用 `stdio` 传输方式（推荐）

在本地机器上运行服务器，并使用 stdio 协议连接客户端，以便与 AI 辅助 IDE（如 VS Code、Android Studio、Cursor）或桌面 AI 应用（如 Gemini CLI）搭配使用。这是最简单且最常见的设置。

配置客户端

将服务器添加到您首选的 AI 客户端的 MCP 配置文件中。请在下方找到您的客户端，以获取具体的已验证说明。

Gemini Code Assist & Gemini CLI

方法 1 - 直接从命令行添加服务器（假设您已安装 Gemini CLI）：
```
 gemini mcp add google-maps-platform-code-assist npx -y @googlemaps/code-assist-mcp@latest
```
- 运行 gemini mcp list 以验证安装。
方法 2 - 将 Code Assist MCP 服务器作为 Gemini CLI 扩展程序安装：
```
gemini extensions install https://github.com/googlemaps/platform-ai.git
```
方法 3 - 手动将 MCP 服务器配置添加到 ~/.gemini/settings.json 文件中。

{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}

Claude Code

方法 1 - 直接从命令行添加服务器（假设您已安装 Claude Code）：
```
    claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest
```
- 运行 claude mcp list 以验证安装。
- Windows 用户：在原生 Windows（而非 WSL）上，您必须使用 cmd /c 封装容器，才能使 npx 命令正常运行。
```
claude mcp add google-maps-platform-code-assist -- cmd /c "npx -y @googlemaps/code-assist-mcp@latest"
```
方法 2 - 手动将服务器添加到 Claude 配置文件 ~/.claude.json 中

"mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": [
        "-y", "@googlemaps/code-assist-mcp@latest"
      ]
    }
  }

Cursor
- <-- 如果您已安装 Cursor，请点击此处直接安装 Google Maps Platform Code Assist MCP。
- 否则，请将其添加到工作区的 .cursor-settings/mcp.json 文件中。
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}
```

Firebase Studio

并安装 Code Assist MCP
添加到 Firebase Studio 工作区中 .idx 文件夹内的项目的 mcp.json 文件中

{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}

Android Studio

创建 mcp.json 文件并将其放置在 Android Studio 的配置目录中。将 Code Assist 服务器添加到列表中：

{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
    }
  }
}

Cline
- 方法 1：使用 Cline MCP GUI 进行安装
- 方法 2：使用 Cline MCP 配置文件手动 / 以编程方式进行安装。配置文件位于：
  - macOS： ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  - Windows： %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  - Linux： ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  - 将以下内容添加到 cline_mcp_settings.json 中的 MCP 配置：
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"],
      "alwaysAllow": [
        "retrieve-instructions",
        "retrieve-google-maps-platform-docs"
      ]
    }
  }
}
```
Roo Code
- 方法 1：使用 Roo MCP GUI 进行安装
- 方法 2：使用 Roo Code 配置文件手动 / 以编程方式进行安装。配置文件位于：
  - macOS： ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
  - Windows： %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json
  - Linux： ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
  - 将以下内容添加到 mcp_settings.json 中的 MCP 配置：
```
{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": ["-y", "@googlemaps/code-assist-mcp@latest"],
      "alwaysAllow": [
        "retrieve-instructions",
        "retrieve-google-maps-platform-docs"
      ]            
    }
  }
}
```
Microsoft Copilot
- 在智能体模式下，依次点击“工具”和顶部标题中的“配置工具”，然后点击“从 NPM 软件包名称安装”（请参阅以下屏幕截图）
- 输入软件包名称 @googlemaps/code-assist-mcp 并按 Enter 键，接受安装并使用默认端口 3000，然后最后一次按 Enter 键以确认更改
Windsurf
- 与上述 Cursor 说明类似。
Kilo Code
- 与上述 Cline 和 Roo Code 说明类似