Google Maps Platform Code Assist 工具包

说明

Google Maps Platform Code Assist 工具包是一个模型上下文协议 (MCP) 服务器,它通过将回答与最新的官方文档和代码示例相关联,增强了用于开发 Google Maps Platform 应用的大语言模型 (LLM) 的回答。

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

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

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

开发者

  • 🪄 让您喜爱的 AI 助理或 IDE 成为 Google Maps Platform 专家。借助 Code Assist,Gemini CLI、Claude Code 和 Cursor 等 AI 代理可以直接在您的开发工作流程中生成代码,并根据最新的官方 Google Maps Platform 文档和代码示例回答开发者的问题。

  • 🚀 无论您是进行精确的 AI 辅助代码更改,还是为新的应用原型进行氛围编码,Code Assist 都能帮助您更快、更轻松地完成任务。

🔧 提供的工具

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

  1. retrieve-instructions:客户端使用的一种辅助工具,用于获取有关如何最好地推断用户意图并制定对 retrieve-google-maps-platform-docs 工具的有效调用的关键系统指令。
  2. retrieve-google-maps-platform-docs:主要工具。它会接收自然语言查询,并将其提交给托管的检索增强生成 (RAG) 引擎。RAG 引擎会搜索最新版本的官方 Google Maps Platform 文档、教程和代码示例,向 AI 返回相关背景信息,以便生成准确的回答。

🛠️ 支持的 MCP 传输

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

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

🚀 用量

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

要求

如需使用 Google Maps Platform 代码辅助工具包,您需要一个安装了 Node.js(建议使用 LTS 版本)和 npm 的环境,以便克隆和运行服务器,还需要一个 MCP 客户端来访问服务器。

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

配置客户端

将服务器添加到您偏好的 AI 客户端的 MCP 配置文件中。在下方找到您的客户,获取经过验证的具体说明。

  1. 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 - 手动将 MCP 服务器配置添加到 ~/.gemini/settings.json 文件中。
    {
      "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
        }
      }
    }
    
  2. Claude Code

    • 方法 1 - 直接从命令行添加服务器(假设您已安装 Claude Code):
          claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist@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-mc@latest"
          ]
        }
      }
    
  3. Cursor

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

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

    • 创建 mcp.json 文件并将其放置在 Android Studio 的配置目录中。将 Code Assist 服务器添加到列表中:
    {
      "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
        }
      }
    }
    
  6. 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"
            ]
          }
        }
        
  7. Roo Code

    • 方法 1:使用 Roo MCP GUI 进行安装
    • 方法 2:使用 Roo 代码配置文件手动 / 以编程方式安装。配置文件位于:
      • 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"
            ]
          }
        }
        
  8. Microsoft Copilot

    • 在代理模式下,依次点击“工具”和顶部标题中的“配置工具”,然后点击“从 NPM 软件包名称安装”(请参见下方屏幕截图)

    • 图片
    • 图片
    • 图片
    • 输入软件包名称 @googlemaps/code-assist-mcp 并按 Enter 键,接受安装并使用默认端口 3000,然后再次按 Enter 键以确认更改

    • 图片
  9. Windsurf

    • 与上述 Cursor 说明类似。
  10. Kilo Code

    • 与上述 Cline 和 Roo 代码说明类似

了解详情

如需详细了解如何安装和使用该工具包以及相关使用条款,请参阅 GitHub 代码库中的 README