mcpField
P
platform-ai

platform-ai

本地服务
github.com/googlemaps开发工具10410 周前更新
代码仓库

关于 platform-ai

platform-ai 是 Google Maps Platform 的 Code Assist MCP 工具包，通过官方文档、代码示例和架构中心资料为 LLM 提供依据，帮助开发者编写地图相关应用。README 提示 npm 版本已弃用，推荐使用 Google 托管的远程 MCP 服务。

主要功能

  1. 01检索 Google Maps Platform 官方文档与代码示例
  2. 02按 API 或产品领域过滤检索结果
  3. 03获取 Google Maps Platform 最佳实践的基础上下文
  4. 04提供 Gemini CLI 扩展安装方式
  5. 05支持连接 Google 托管的远程 MCP 服务

适用场景

  1. 01在应用中集成 Routes API 或 Places API 时查阅官方示例
  2. 02在编码 Agent 中获取最新的地图平台文档依据
  3. 03比较 Geocoding 与 Address Validation 等 API 的适用场景

MCP 相关

该项目是一个 MCP 服务，提供 retrieve-google-maps-platform-docs 和 retrieve-instructions 两个工具，并可通过远程端点 mapscodeassist.googleapis.com/mcp 接入。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "ryanbaumann-platform-ai": {
      "command": "npx",
      "args": [
        "-y",
        "@googlemaps/code-assist-mcp"
      ]
    }
  }
}
启动命令npx -y @googlemaps/code-assist-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@googlemaps/code-assist-mcp0.2.0

工具

2

收录的工具列表 · 更新于 2 周前

参数类型必填说明
promptstring是你是 Retrieval-Augmented Generation (RAG) 系统的提示词工程专家。 **说明：** 1. 分析用户的意图（例如，他们是想实现、排查问题还是学习）。 2. 确定用户询问的 Google Maps Platform 产品和功能。 3. 必须保留用户在原始查询中提供的所有细节。 4. 不要删除请求中提供的关键信息，例如城市、国家/地区、地址或 lat/lng。 5. 添加与 RAG 系统相关的额外信息，但不得删除用户提供的信息。
search_contextarray否如果用户提示词含糊或范围过广，提供补充上下文以辅助搜索。填写用户提示词中指定的现有 Google Maps Platform 产品或功能名称。

详细介绍

[npm][npm-pkg] Alpha Contributors

面向 AI 的 Google Maps Platform 资源

说明

警告

Google Maps Platform Code Assist 的 npm 版本已弃用。自 2026 年 7 月 1 日起将不再提供。请使用本 README 中介绍的安全托管远程 MCP 版本作为主要连接方式。

此代码仓库包含 Google Maps Platform Code Assist 工具包，这是一个模型上下文协议（MCP）服务，可通过以官方、最新的文档和代码示例为依据，增强大模型（LLM）在使用 Google Maps Platform 开发应用时生成的回答。

🔧 可用的 MCP 工具（gmp-code-assist）

你可以使用 gmp-code-assist MCP 服务及其以下实用工具：

  • retrieve-google-maps-platform-docs：通过 RAG 搜索 Google Maps Platform 文档、代码示例、架构中心和 GitHub 代码仓库。
    • 参数：llmQuery（必填字符串查询）、filter（可选的 API／产品领域筛选条件）、source（可选的字符串调用方标识符，最多 64 个字符）。
  • retrieve-instructions：获取有关 Google Maps Platform 最佳实践的基础背景信息。
    • 参数：name（必填字符串，格式应为 "instructions"）。

为 Gemini CLI 安装 Google Maps Platform Code Assist 扩展

  1. 安装 Gemini CLI（其他安装方式）
npm install -g @google/gemini-cli
  1. 安装 Google Maps Platform 扩展

    • 选项 1 - 将 Code Assist 安装为 Gemini CLI 扩展（包含上下文提示词、Code Assist MCP 工具和 Google Maps Platform CLI 主题）：

      gemini extensions install https://github.com/googlemaps/platform-ai.git
      • 运行 gemini mcp list 验证安装。

    • 选项 2 - 将 MCP 服务配置手动添加到 ~/.gemini/settings.json 文件，以安全连接到 Google 托管的远程服务：

      {
  "mcpServers": {
   "gmp-code-assist": {
     "httpUrl": "https://mapscodeassist.googleapis.com/mcp"
   }
  }
}

Google Maps Platform Agent 技能

如需为 AI Agent 配备专用、可移植的 Google Maps Platform 工作流和最佳实践，请查看官方 Google Maps Platform Agent Skills 代码仓库。

在 Gemini CLI 中安装 Agent 技能：

gemini skills install https://github.com/googlemaps/agent-skills.git

为其他 MCP 客户端安装 Google Maps Platform Code Assist 工具包

有关使用任何 MCP 客户端安装和使用该工具包的信息，以及使用条款，请参阅 Code Assist 工具包 README。

示例提示词

使用以下示例提示词，开始使用 Code Assist MCP 服务或受支持的 AI Agent：

  • 向我展示如何使用 Routes API，并在 React + Typescript 中的地图上显示路线。
  • 我想将地图从 2D 升级到 3D 照片级真实效果——有哪些选项？如何在现有代码库中实现？
  • 将我的 Places API (new) Text Search API 实现改为使用 Places UI Kit。估算这项变更能为每位用户节省多少费用。
  • 解释 Address Validation 和 Geocoding 的区别。针对我当前代码库中的电商结账场景，我应该使用哪一种？为什么？
  • 我需要一个 API 密钥——你能获取一个并将其添加到我的应用环境密钥中吗？

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。