Google Maps MCP 服务器

用于 Google Maps API 的 MCP 服务器。

工具

1. maps_geocode

   • 将地址转换为坐标
   • 输入：address（字符串）
   • 返回值：位置、格式化地址、地点ID

2. maps_reverse_geocode

   • 将坐标转换为地址
   • 输入：
     • latitude（数字）
     • longitude（数字）
   • 返回值：格式化地址、地点ID、地址组件

3. maps_search_places

   • 使用文本查询搜索地点
   • 输入：
     • query（字符串）
     • location（可选）：{ latitude: 数字, longitude: 数字 }
     • radius（可选）：数字（米，最大50000）
   • 返回值：包含名称、地址、位置的地点数组

4. maps_place_details

   • 获取地点的详细信息
   • 输入：place_id（字符串）
   • 返回值：名称、地址、联系方式、评分、评论、营业时间

5. maps_distance_matrix

   • 计算点之间的距离和时间
   • 输入：
     • origins（字符串数组）
     • destinations（字符串数组）
     • mode（可选）："driving" | "walking" | "bicycling" | "transit"
   • 返回值：距离和持续时间矩阵

6. maps_elevation

   • 获取地点的海拔数据
   • 输入：locations（{latitude, longitude} 数组）
   • 返回值：每个点的海拔数据

7. maps_directions

   • 获取点之间的路线
   • 输入：
     • origin（字符串）
     • destination（字符串）
     • mode（可选）："driving" | "walking" | "bicycling" | "transit"
   • 返回值：包含步骤、距离、持续时间的路线详情

配置

API 密钥

按照此处的说明获取 Google Maps API 密钥。

在 Claude Desktop 中使用

在你的 claude_desktop_config.json 中添加以下内容：

Docker

{
  "mcpServers": {
    "google-maps": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GOOGLE_MAPS_API_KEY",
        "mcp/google-maps"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "google-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-google-maps"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

构建

Docker 构建：

docker build -t vonwig/google-maps:mcp -f src/google-maps/Dockerfile .

许可证

此 MCP 服务器采用 MIT 许可证。这意味着你可以自由地使用、修改和分发该软件，但需遵守 MIT 许可证中的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。