地图API服务

Google Maps MCP Server 是一个提供地理编码、逆地理编码、地点搜索、距离计算等功能的API服务,适用于需要地图和位置服务的应用开发。

  • by modelcontextprotocol
  • JavaScript
  • 本地部署
  • 150 星标
  • 更新于
在 GitHub 查看 modelcontextprotocol/servers-archived

使用说明

谷歌地图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密钥 这里.

使用Claude Desktop

将以下内容添加到您的 claude_desktop_config.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

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

使用VS代码

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

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

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

请注意 mcp 中不需要密钥 .vscode/mcp.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安装:

{
  "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构建:

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

许可证

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