Google Maps MCP Server

基本能力

产品定位

mcp-hello-world 是一个基于 Google Maps API 的 MCP 服务器，主要用于处理与地理位置相关的各种服务。

核心功能

1. 地址解析（maps_geocode）：将地址转换为坐标。
2. 反向地址解析（maps_reverse_geocode）：将坐标转换为地址。
3. 地点搜索（maps_search_places）：根据文本查询搜索地点。
4. 地点详情查询（maps_place_details）：获取地点的详细信息，如名称、地址、联系方式、评分、评论和营业时间等。
5. 距离矩阵计算（maps_distance_matrix）：计算多个起点和终点之间的距离和时间。
6. 海拔数据获取（maps_elevation）：获取指定位置的海拔数据。
7. 路线规划（maps_directions）：获取两点之间的路线详情，包括步骤、距离和持续时间。

适用场景

1. 需要将地址转换为坐标或反之的应用。
2. 需要搜索地点或获取地点详细信息的应用。
3. 需要计算多个地点之间距离和时间的应用。
4. 需要获取海拔数据的应用。
5. 需要规划路线的应用。

工具列表

1. maps_geocode：将地址转换为坐标。
2. maps_reverse_geocode：将坐标转换为地址。
3. maps_search_places：根据文本查询搜索地点。
4. maps_place_details：获取地点的详细信息。
5. maps_distance_matrix：计算多个起点和终点之间的距离和时间。
6. maps_elevation：获取指定位置的海拔数据。
7. maps_directions：获取两点之间的路线详情。

常见问题解答

1. 如何获取 Google Maps API 密钥？
2. 按照 Google Maps API 密钥获取指南 进行操作。

使用教程

使用依赖

1. 获取 Google Maps API 密钥。

安装教程

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>"
      }
    }
  }
}

调试方式

1. 确保已正确安装 Docker 或 NPX。
2. 确保已正确配置 Google Maps API 密钥。
3. 运行相应的安装命令，检查是否有错误输出。

构建

Docker 构建

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

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。