@googlemaps/code-assist-mcp

中文文档
0.2.1发布于 2025/12/05ISCES Module近 30 天下载 7942

Google 地图平台代码协助 MCP(模式背景协议)服务

此软件包已被标记为弃用

The npm version of Code Assist is deprecated. It will be decommissioned on June 1, 2026. Please use the remote streamable HTTP version at https://mapscodeassist.googleapis.com/mcp

中文使用文档
文档目录17 节
  1. 说明
  2. 福利
  3. 提供的工具
  4. 支持的MCP 运输
  5. 使用量
  6. 所需资源
  7. 使用代码辅助作为本地 MCP 服务器 stdio 运输(建议)
  8. 可用设置
  9. 端口配置
  10. 源配置
  11. 本地可流 HTTP 指南
  12. 何时使用本地可流取的 HTTP
  13. 本地可流式 HTTP 设置
  14. 用 cURL 测试本地设置
  15. 在可流取的 HTTP 下 Cloud 运行时用作远程 MCP 服务器
  16. 服务条件
  17. 支助

npm Alpha License Discord Install MCP Server Try in Firebase Studio

Google Maps Platform Logo Google 地图平台代码辅助工具箱

阿尔法版本

说明

Google Maps平台代码辅助工具箱是一款"模式背景协议"(MCP)服务器,通过在官方,最新文档和代码样本中打地基来增强用于与Google Maps平台开发应用的大型语言模型(LLM)的响应.

由于MCP服务器在模型被激发时访问内容,所以LLM有关Google地图平台的上下文不必局限于模型培训日的现有数据.

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

  • 谷歌地图平台文档
  • 谷歌地图平台服务条款
  • 谷歌地图平台信托中心
  • Google Maps 平台中的代码寄存器 官方 GitHub 组织

福利

  • 让你最喜欢的AI助手或IDE成为Google地图平台专家. 在"代码协助"(Code Assistance)中,双子座CLI,克洛德代码等AI Agents和Cursor可以生成代码并解答基于最新,Google官方地图平台文档和代码样本的开发者问题——直接存在于您dev工作流程中.

  • 您是否正在对 AI- Assisted 代码进行精密的修改, 或是对一个新的应用原型进行天气编码 - 代码协助可以帮助您更快和更容易地完成任务 .

以下是MCP客户端用安装的代码Assistance MCP对用户问题的回应:

[注] 这是通过RAG服务提供Google Maps平台文档访问的MCP服务器的存储器. 这不是谷歌地图平台核心服务.


提供的工具

MCP服务器为AI客户端披露了以下工具:

  1. retrieve-instructions: 客户端用于获取关键系统指示的帮助工具,说明如何最好地说明用户意图,并给用户发出有效呼叫 retrieve-google-maps-platform-docs 工具.
  2. retrieve-google-maps-platform-docs:主要工具. 它需要自然语言查询,并将其提交到一个托管的检索增强生成(RAG)引擎. RAG引擎搜索了Google Maps平台官方文档的新版本,教程,和代码样本,将相关上下文还给AI以生成准确的响应.

支持的MCP 运输

这个服务器支持两个标准的MCP通信协议:

  • stdio: 这是当客户端通过一个 command。它通过标准输入/输出流进行通信,使其成为本地命令行执行的理想.
  • Streamable HTTP: 服务器显示一个 /mcp 接受 POST 请求的结束点 。 这被客户端使用 通过一个连接 url ,是远程服务器连接的标准。 我们的实施工作支持进行实时互动反应.

使用量

您可以在本地开发机上或远程在Google Cloud Run上运行代码协助 MCP 服务器.

所需资源

要使用 Google Maps 平台代码辅助工具箱,您需要一个环境 节点.js (LTS版本推荐)和npm安装,以克隆并运行服务器,以及一个MCP客户端可以访问服务器.

在本地机器上运行服务器并使用 stdio 用于AI辅助IDEs(如VS代码,Android Studio, Cursor)或桌面AI应用程序(如双子座CLI)的协议. 这是最简单和最常见的设置.

配置客户端

将服务器添加到您首选的 AI 客户端的 MCP 配置文件 。 在下面找到您的客户端 以获取经过核实的具体指令 .

  1. 双子代码辅助 & 双子代码 CLI

    • 选项 1 - 从命令行直接添加服务器( 假设您已经安装双子座 CLI ) :
       gemini mcp add google-maps-platform-code-assist npx -y @googlemaps/code-assist-mcp@latest
      
      • 通过运行验证安装 gemini mcp list。 。 。 .
    • 选项2 - 安装代码协助 MCP 服务器作为双子座 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"]
        }
      }
    }
    
  2. 克劳德代码

    • 选项 1 - 从命令行直接添加服务器( 假设您已经安装 Claude 代码 ) :
          claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest
      
      • 通过运行验证安装 claude mcp list。 。 。 .
      • 窗口用户 : 在本地窗口( 不是 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"
          ]
        }
      }
    
  3. 光标

    • Install MCP Server < -- -- 如果您已经安装了光标, 请点击这里直接安装 Google Maps 平台代码 Asistance MCP .
    • 否则,加进你的工作空间 .cursor-settings/mcp.json 文档.
    {
      "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
        }
      }
    }
    
  4. 消防基地工作室

    • Try in Firebase Studio 已安装密码协助 MCP
    • 添加到您的项目 mcp.json 文档中 .idx firebase Studio 工作空间中的文件夹
    {
      "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
        }
      }
    }
    
  5. Android 工作室

    • 创建一个 mcp.json 文档并放入 配置目录 android Studio的电影 将代码辅助服务器添加到列表中 :
    {
      "mcpServers": {
        "google-maps-platform-code-assist": {
          "command": "npx",
          "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
        }
      }
    }
    
  6. 线

    • 备选案文1:使用 Cline MCP 图形界面
    • 选项2:使用 Cline MCP 配置文件手动/程序安装. 配置文件位于 :
      • 马可斯: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
      • 窗口 : %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
      • 林纳: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
      • 在您的 MCP 配置中添加以下内容 cline_mcp_settings.json数字 :
        {
          "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 代码

    • 备选案文1:使用 Roo MCP 图形界面
    • 选项2:使用Roo代码配置文件手动/程序安装. 配置文件位于 :
      • 马可斯: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
      • 窗口 : %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json
      • 林纳: ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
      • 在您的 MCP 配置中添加以下内容 mcp_settings.json数字 :
        {
          "mcpServers": {
            "google-maps-platform-code-assist": {
              "command": "npx",
              "args": ["-y", "@googlemaps/code-assist-mcp@latest"],
              "alwaysAllow": [
                "retrieve-instructions",
                "retrieve-google-maps-platform-docs"
              ]            
            }
          }
        }
        
  8. 微软副驾驶

    • 在代理模式下,点击"工具",然后在顶部标题"配置工具"中再点击"从国家防范机制包名中安装"(见下文截图)
    • image
    • image
    • image
    • 输入 pakge 名称 @googlemaps/code-assist-mcp 和 ENTER,接受安装并使用默认端口 3000,然后 ENDER 最后一次确认更改
    • image
  9. 风起浪起

    • 类似于以上光标指令.
  10. Kilo 代码

    • 类似于以上 Cline 和 Roo 代码指令

可用设置

端口配置

默认情况下, 服务器运行在端口 3000。 您可以使用 --port 旗帜或一个 PORT 环境变量。 这个 --port 旗帜优先.

示例:使用端口 5000

在你身边 mcp.json数字 :

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

或有环境变量:

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

如果指定的端口不可用,服务器会自动在随机可用的端口上找到并启动.

源配置

您可以指定一个 SOURCE 用于跟踪请求来源的环境变量。 默认值为 github。 。 。 .

示例: 设置源到 my_company_name

在你身边 mcp.json数字 :

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

本地可流 HTTP 指南

对于需要整合Google Maps平台代码的开发者,请使用 可流取的 HTTP 本指南提供设置指令和测试步骤.

何时使用本地可流取的 HTTP

当 :

  • 您的客户端需要基于 URL 的连接而不是命令执行
  • 您的本地开发环境需要基于 HTTP 的通信
  • 您正在建立和测试自定义集成,通过HTTP进行通信

本地可流式 HTTP 设置

1. 启动服务器

本地运行 MCP 服务器, 指定端口 :

npx -y @googlemaps/code-assist-mcp@latest --port 3215

服务器将在 http://localhost:3215/mcp。 。 。 .

2. 配置客户端

更新您的客户端的 MCP 配置以连接到本地服务器 URL .

说明: 检查一下 type 您的 MCP 配置中的参数被正确设定为您的特定客户端 。 例如,Roo代码使用 "type": "streamable-http",而 Cline 则使用 "type": "streamableHttp"。 。 。 .

Roo 代码( VS 代码扩展)

添加为 mcp_settings.json数字 :

{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "type": "streamable-http",
      "url": "http://localhost:3215/mcp",
      "alwaysAllow": [
        "retrieve-instructions",
        "retrieve-google-maps-platform-docs"
      ]
    }
  }
}

线( VS 代码扩展)

添加为 cline_mcp_settings.json数字 :

{
  "mcpServers": {
    "google-maps-platform-code-assist": {
      "type": "streamableHttp",
      "url": "http://localhost:3215/mcp",
      "alwaysAllow": [
        "retrieve-instructions",
        "retrieve-google-maps-platform-docs"
      ]
    }
  }
}

用 cURL 测试本地设置

通过发送一个 initialize 请:

# Test server initialization
curl -X POST http://localhost:3215/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {"name": "test-client", "version": "1.0.0"}
    }
  }'

预期答复: 服务器将以包含其能力的SSE事件响应.

event: message
data: {"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-03-26","capabilities":{"tools":{},"logging":{},"resources":{}},"serverInfo":{"name":"code-assist-mcp","version":"0.1.3"}}}

在可流取的 HTTP 下 Cloud 运行时用作远程 MCP 服务器

运行Google Cloud Run上的服务器,并从您本地的机器连接到它. 如果您的客户端需要远程托管, 可流的 HTTP 端点, 则此功能是有用的 .

[尖叫声] 这些指令保护了服务器, 只有您可以访问它, 并附带您的应用程序、 MCP 客户端或代理的 IAM 角色 .

1. 先决条件

安装 谷歌云SDK 并认证您的账户 :

gcloud auth login
gcloud config set project YOUR_PROJECT_ID

2. 部署到云跑

此命令从此寄存器的源代码部署服务器, 并确保它是 没有 向公众开放.

gcloud run deploy google-maps-code-assist-mcp --source . --no-allow-unauthenticated

当提示时,选择一个区域(例如, us-central1) (中文(简体) ).

3. 安全连接

在您的本地机器上运行 Cloud Run 代理服务器 。 这将创建一个从本地端口到您的远程服务器的安全隧道, 并用您的 gcloud 身份证明.

gcloud run services proxy google-maps-code-assist-mcp --port=8999 --region=YOUR_REGION

现在, http://localhost:8999 在你的机器上 安全连接到你的"云跑"服务.

4. 配置客户端

更新客户端的 MCP 配置以指向本地代理 .

  • 使用 url 属性超过可流的 HTTP :

    "google-maps-platform-code-assist": {
      "url": "http://localhost:8999/mcp",
      "type": //Either "streamableHttp" or "streamable-http", depending on your MCP client
    }
    

5. 连接GCP服务(替代本地代理)

将另一个GCP服务连接到远程部署的 Cloud Run MCP 服务器,例如 代理开发工具包(ADK) gCP Cloud 运行中或 Vertex AI 代理引擎,您可以使用以下IAM角色将客户端直接连接到远程MCP服务上可流HTTP:

# Grant Cloud Run Invoker role to the service account
gcloud run services add-iam-policy-binding google-maps-code-assist-mcp \
 --member="serviceAccount:[email protected]" \
 --role="roles/run.invoker" \
 --region=YOUR_REGION

现在您的 GCP 主机应用或代理可以直接连接到远程托管的 MCP 服务器 URL 超流 HTTP.

6. 健康检查终点点

此服务器执行包含一个标准 /health 终点 这是Cloud Run等平台部署的服务的最佳做法,Cloud Run用来检查服务器的运行状态.

  • HTTP 密码 /health 终点: 一个简单的 GET 请求到这个终点(例如, https://your-service-url/health)将返回 a 200 OK 状态带有 JSON 有效载荷,包含服务器状态,活动会话次数,以及服务器运行时的时间戳。 这用于基础设施一级的健康检查.
  • MCP 磁共振 ping 工具: 这与本协议不同 ping 由 MCP 规格定义的实用性 。 这个 ping 工具是发送的 JSON- RPC 请求 之后 设置一个会话以检查该会话的活性 协议连接,而 /health 端点检查 HTTP 服务器 自己来.

服务条件

这个工具包提供了描述谷歌地图平台服务使用情况的工具. 使用Google地图平台服务受Google地图平台制约 服务条件但是,如果你的账单地址在欧洲经济区,谷歌地图平台 EEA 服务条件 您将申请使用服务。 功能因区域而异. 学多点。 。 。 .

这个工具包不是谷歌地图平台核心服务. 因此,Google地图平台服务条款(如技术支持服务,服务级别协议,以及折旧政策)不适用于本寄存器中的代码或它所呼吁的RAG服务.

支助

通过一个开放源码提供这一工具包 许可证它不受Google地图平台支持(技术支持服务准则、SLA或 折旧政策) (中文(简体) ). 然而,图书馆使用的任何Google地图平台服务仍受Google地图平台服务条款的约束.

如果您找到错误, 或者有特性请求, 请 提交问题 (原始内容存档于2018-09-29). on GitHub. 如果您想从其他 Google 地图平台开发者那里得到技术问题的答案,请通过我们中的一个 开发者社区频道请检查date=中的日期值 (帮助) 贡献指南。 。 。 .

你也可以和我们讨论这个工具箱 Discord 服务器。 。 。 .

版本与发布记录

@googlemaps/code-assist-mcp 共发布 10 个版本,首次发布于 2025/07/31;过去 12 个月发布了 1 个版本。

版本发布日期距今
0.2.1latest2025/12/0511 个月前
0.2.02025/09/101.2 年前
0.1.72025/08/291.2 年前
0.1.62025/08/291.2 年前
0.1.52025/08/111.3 年前
0.1.42025/08/111.3 年前

关于 @googlemaps/code-assist-mcp 的常见问题

@googlemaps/code-assist-mcp 是什么?

Google 地图平台代码协助 MCP(模式背景协议)服务注意:该包已被作者标记为弃用——The npm version of Code Assist is deprecated. It will be decommissioned on June 1, 2026. Please use the remote streamable HTTP version at https://mapscodeassist.googleapis.com/mcp

如何安装 @googlemaps/code-assist-mcp?

在项目目录运行 npm install @googlemaps/code-assist-mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 code-assist-mcp,可以用 npx code-assist-mcp 直接运行。

@googlemaps/code-assist-mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/googlemaps__code-assist-mcp 是否存在。

@googlemaps/code-assist-mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@googlemaps/code-assist-mcp 可以商用吗?

@googlemaps/code-assist-mcp 使用 ISC 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@googlemaps/code-assist-mcp 的下载量有多少?

根据 npm 官方下载统计,@googlemaps/code-assist-mcp 在 2026/10/17 – 2026/11/15 这 30 天内被下载 7,942 次,日均约 265 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@googlemaps/code-assist-mcp 还在维护吗?

最新版本 0.2.1 发布于 2025/12/05(11 个月前);至今共发布 10 个版本,其中过去 12 个月发布了 1 个;首次发布于 2025/07/31。作者已将其标记为弃用,新项目建议寻找替代方案。