项目简介

该项目是一个实现了 Model Context Protocol (MCP) 的服务器，旨在将 Google Maps Grounding API 的强大地理位置信息能力与 Gemini AI 的自然语言理解和生成能力融合。它允许 LLM 客户端通过标准化的 MCP 协议，进行基于 AI 的地图搜索，并获取丰富、结构化的地理位置数据和智能分析。

主要功能点

AI 驱动的地图搜索: 支持自然语言查询，例如“附近的意大利餐厅”、“旧金山的咖啡馆”等。
地理位置感知: 可通过经纬度提供位置上下文，优化“附近”搜索结果。
详细地面信息: 返回包括地点 ID、URI 和结构化数据在内的详细地理信息。
多模型支持: 可选择不同的 Gemini 模型进行内容生成。
交互式地图组件: 可选择在响应中启用交互式地图小部件。

安装步骤

获取 Google Gemini API Key:
- 访问 Google AI Studio。
- 创建或选择一个项目。
- 生成一个新的 API 密钥。
- 确保为您的项目启用了 Gemini API。

克隆仓库并安装依赖:

git clone https://github.com/boringmarketer/guides.git
cd guides/google-maps-mcp-server
npm install
npm run build

服务器配置

MCP 客户端（如 Claude Code 或其他兼容客户端）需要通过以下 JSON 配置来连接此 MCP 服务器。请将 'command' 字段中的路径替换为实际的 'index.js' 文件路径，并将 'GOOGLE_GEMINI_API_KEY' 替换为您自己的 API 密钥。

{
  "mcpServers": {
    "google-maps-grounding": {
      "command": "node", // 启动服务器的命令，node 是运行 JavaScript 文件的解释器
      "args": ["/your/path/to/guides/google-maps-mcp-server/build/index.js"], // MCP 服务器的主程序路径
      "env": {
        "GOOGLE_GEMINI_API_KEY": "YOUR_API_KEY_HERE" // 用于访问 Google Gemini API 的密钥
      }
    }
  }
}

基本使用方法

配置完成后，LLM 客户端即可通过调用名为 'google_maps_search' 的工具与服务器交互。例如，您可以向客户端发送一个请求，要求其调用此工具来搜索信息：

工具名称: 'google_maps_search'
描述: 使用 Google Maps 和 Gemini AI 搜索地点、餐厅、商家，或获取基于位置的信息。
输入参数:
- 'query' (必填，字符串): 搜索查询，例如“我附近的咖啡馆”、“纽约市的博物馆”。
- 'latitude' (可选，数字): 用于提供位置上下文的纬度。
- 'longitude' (可选，数字): 用于提供位置上下文的经度。
- 'model' (可选，字符串): 指定使用的 Gemini 模型，默认为 'gemini-2.5-flash'。
- 'enableWidget' (可选，布尔值): 是否在响应中启用交互式地图小部件，默认为 'false'。

客户端收到工具调用请求后，服务器将处理查询，调用 Google Maps Grounding API，并返回 AI 生成的、包含地点详情和 URI 等信息的响应。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息