Back to MCP directory
publicPublicdnsLocal runtime

MCP-Google-Maps

一个基于MCP协议的Google Maps功能服务,提供地点搜索、地理编码、路线规划等地图相关功能。

article

README

🚀 MCP 谷歌地图

MCP 谷歌地图是一个基于 Model Context Protocol (MCP) 的服务器,专为谷歌地图功能打造。它通过 MCP 接口,为用户提供场所搜索、地理编码、路线规划等一系列实用功能。

🚀 快速开始

MCP 谷歌地图可快速集成到你的项目中,为你提供强大的谷歌地图功能。以下是详细的安装与测试步骤。

安装

首先全局安装该包:

npm install -g mcp-google-maps

测试

你可以通过运行以下命令测试 MCP 服务器是否正常工作:

npx mcp-google-maps

✨ 主要特性

  • 场所搜索:轻松查找附近的各类场所。
  • 场所详细信息:获取特定场所的详细资料。
  • 地理编码和逆向地理编码:实现地址与坐标的相互转换。
  • 距离矩阵:计算多个起点和终点之间的距离。
  • 路线规划:规划两点之间的最佳路线。
  • 高程数据:获取指定位置的高程信息。
  • 静态地图生成:生成静态的地图图像。

📦 安装指南

要在你的 MCP 客户端中使用此服务,需将以下内容添加到你的 MCP 配置文件中:

{
    "mcpServers": {
        "google-maps": {
            "command": "npx",
            "args": ["-y", "mcp-google-maps"],
            "env": {
                "GOOGLE_MAPS_API_KEY": "your_api_key_here",
                "DEFAULT_LANGUAGE": "en",
                "DEFAULT_REGION": "US",
                "MAX_REQUESTS_PER_SECOND": "50",
                "MAX_REQUESTS_PER_DAY": "100000",
                "ENABLE_CACHING": "true",
                "CACHE_TTL": "3600"
            },
            "enabled": true
        }
    }
}

💻 使用示例

基础用法

通过 MCP 接口,你可以使用以下命令调用相应的谷歌地图功能:

  • search_nearby:搜索附近的场所
  • get_place_details:获取特定场所的详细信息
  • get_geocode:将地址转换为坐标
  • get_reverse_geocode:将坐标转换为地址
  • get_distance_matrix:计算多个起点和终点之间的距离
  • get_directions:获取两点之间的路线规划
  • get_elevation:获取位置的高程数据
  • generate_static_map:生成静态地图图像

📄 许可证

本项目采用 MIT 许可证。

👨‍💻 作者

artixz

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client