MCP-Google-Maps

🚀 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