### [地图API服务](https://s.ddm.chat/link/714)

**Published:** 2026-07-23T02:00:22

**Author:** 颠倒梦

**Excerpt:** Google Maps MCP Server 是一个提供地理编码、逆地理编码、地点搜索、距离计算等功能的API…

# 谷歌地图MCP服务器

用于谷歌地图API的MCP服务器。

## 工具

1.  `maps_geocode`
    
    -   将地址转换为坐标
    -   输入： `address` （字符串）
    -   返回：位置、格式化地址、地点id
2.  `maps_reverse_geocode`
    
    -   将坐标转换为地址
    -   输入：
        -   `latitude` （编号）
        -   `longitude` （编号）
    -   返回：格式化地址、地点id、地址组件
3.  `maps_search_places`
    
    -   使用文本查询搜索地点
    -   输入：
        -   `query` （字符串）
        -   `location` （可选）：{纬度：数字，经度：数字}
        -   `radius` （可选）：数量（米，最大50000）
    -   返回：包含名称、地址和位置的地点数组
4.  `maps_place_details`
    
    -   获取某个地方的详细信息
    -   输入： `place_id` （字符串）
    -   返回：姓名、地址、联系方式、评分、评论、开放时间
5.  `maps_distance_matrix`
    
    -   计算点之间的距离和时间
    -   输入：
        -   `origins` （字符串\[\]）
        -   `destinations` （字符串\[\]）
        -   `mode` （可选）：“驾驶”|“步行”|“骑自行车”|“公交”
    -   返回值：距离和持续时间矩阵
6.  `maps_elevation`
    
    -   获取位置的高程数据
    -   输入： `locations` （{纬度、经度}数组）
    -   返回：每个点的高程数据
7.  `maps_directions`
    
    -   获取点之间的方向
    -   输入：
        -   `origin` （字符串）
        -   `destination` （字符串）
        -   `mode` （可选）：“驾驶”|“步行”|“骑自行车”|“公交”
    -   返回：路线详细信息，包括步骤、距离、持续时间

## 设置

### API密钥

按照说明获取Google Maps API密钥 [这里](https://developers.google.com/maps/documentation/javascript/get-api-key#create-api-keys).

### 使用Claude Desktop

将以下内容添加到您的 `claude_desktop_config.json`:

#### 码头工人

```json
{
  "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

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

### 使用VS代码

为了快速安装，请使用下面的一键安装按钮之一。..

[](https://insiders.vscode.dev/redirect/mcp/install?name=google-maps&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22maps_api_key%22%2C%22description%22%3A%22Google%20Maps%20API%20Key%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-google-maps%22%5D%2C%22env%22%3A%7B%22GOOGLE_MAPS_API_KEY%22%3A%22%24%7Binput%3Amaps_api_key%7D%22%7D%7D)[](https://insiders.vscode.dev/redirect/mcp/install?name=google-maps&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22maps_api_key%22%2C%22description%22%3A%22Google%20Maps%20API%20Key%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40modelcontextprotocol%2Fserver-google-maps%22%5D%2C%22env%22%3A%7B%22GOOGLE_MAPS_API_KEY%22%3A%22%24%7Binput%3Amaps_api_key%7D%22%7D%7D&quality=insiders)

[](https://insiders.vscode.dev/redirect/mcp/install?name=google-maps&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22maps_api_key%22%2C%22description%22%3A%22Google%20Maps%20API%20Key%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Fgoogle-maps%22%5D%2C%22env%22%3A%7B%22GOOGLE_MAPS_API_KEY%22%3A%22%24%7Binput%3Amaps_api_key%7D%22%7D%7D)[](https://insiders.vscode.dev/redirect/mcp/install?name=google-maps&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22maps_api_key%22%2C%22description%22%3A%22Google%20Maps%20API%20Key%22%2C%22password%22%3Atrue%7D%5D&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22mcp%2Fgoogle-maps%22%5D%2C%22env%22%3A%7B%22GOOGLE_MAPS_API_KEY%22%3A%22%24%7Binput%3Amaps_api_key%7D%22%7D%7D&quality=insiders)

对于手动安装，请将以下JSON块添加到VS Code中的用户设置（JSON）文件中。您可以按 `Ctrl + Shift + P` 和打字 `Preferences: Open User Settings (JSON)`.

您可以选择将其添加到名为的文件中 `.vscode/mcp.json` 在您的工作空间中。这将允许您与他人共享配置。

> 请注意 `mcp` 中不需要密钥 `.vscode/mcp.json` 文件。

```json
{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "maps_api_key",
        "description": "Google Maps API Key",
        "password": true
      }
    ],
    "servers": {
      "google-maps": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-google-maps"],
        "env": {
          "GOOGLE_MAPS_API_KEY": "${input:maps_api_key}"
        }
      }
    }
  }
}
```

对于Docker安装：

```json
{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "maps_api_key",
        "description": "Google Maps API Key",
        "password": true
      }
    ],
    "servers": {
      "google-maps": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "mcp/google-maps"],
        "env": {
          "GOOGLE_MAPS_API_KEY": "${input:maps_api_key}"
        }
      }
    }
  }
}
```

## 构建

Docker构建：

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

## 许可证

此MCP服务器根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。



---