使用说明

项目简介

Google Maps MCP 服务器是一个基于 Model Context Protocol (MCP) 的后端实现,旨在为大型语言模型(LLM)提供访问 Google Maps 服务的工具。通过此服务器,LLM 客户端可以调用各种 Google Maps API,例如地理编码、反向地理编码、地点搜索、地点详情、距离矩阵、海拔查询和路线规划等。

主要功能点

  • 地理编码 (Geocode): 将地址转换为经纬度坐标。
  • 反向地理编码 (Reverse Geocode): 将经纬度坐标转换为地址。
  • 地点搜索 (Search Places): 根据关键词和位置信息搜索地点,例如餐厅、地标等。
  • 地点详情 (Place Details): 获取特定地点的详细信息,如地址、电话、评价、营业时间等。
  • 距离矩阵 (Distance Matrix): 计算多个起点和终点之间的距离和 travel time。
  • 海拔查询 (Elevation): 获取地球上特定位置的海拔高度。
  • 路线规划 (Directions): 获取两点之间的路线 directions,支持 driving、walking、bicycling 和 transit 等多种 travel modes。

安装步骤

由于此仓库是 Model Context Protocol 参考服务器集合的一部分,您无需单独下载此 Google Maps 服务器。您可以通过以下命令,使用 'npx' 直接运行此服务器:

npx -y @modelcontextprotocol/server-google-maps

服务器配置

为了让 MCP 客户端(例如 Claude Desktop)连接到 Google Maps MCP 服务器,您需要在客户端的 MCP 服务器配置中添加以下 JSON 代码。请务必替换 '<YOUR_GOOGLE_MAPS_API_KEY>' 为您自己的 Google Maps API Key。

{
  "mcpServers": {
    "google-maps": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-google-maps"],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_GOOGLE_MAPS_API_KEY>"  // 替换为您的 Google Maps API Key
      }
    }
  }
}

基本使用方法

  1. 启动服务器: 按照上述安装步骤启动 Google Maps MCP 服务器。

  2. 配置客户端: 将上述 JSON 配置添加到您的 MCP 客户端配置文件中,并确保已设置正确的 Google Maps API Key。

  3. 在客户端中使用: 在 MCP 客户端中,您可以使用自然语言调用 Google Maps 提供的工具,例如:

    • 'Use maps to geocode "1600 Amphitheatre Parkway, Mountain View, CA"' (使用地图地理编码地址)
    • 'Search for pizza places near Times Square using maps' (使用地图搜索时代广场附近的披萨店)
    • 'Get directions from Paris to Rome by driving with maps' (使用地图获取从巴黎到罗马的 driving 路线)

    LLM 将根据您的指令,自动调用相应的 Google Maps 工具,并返回结果。

注意:您需要拥有有效的 Google Maps API Key 才能使用此服务器。请在 Google Cloud Console 中创建项目并启用 Maps API,然后生成 API 密钥。

信息

分类

网页与API