使用说明

项目简介

这是一个基于 Model Context Protocol (MCP) 的服务器端实现，旨在将 Google Maps 的核心功能（如地理编码、地点搜索、距离计算、路线规划等）通过标准化的 MCP 协议暴露给支持 MCP 的大型语言模型（LLM）客户端。通过集成此服务器，LLM 可以直接调用 Google Maps 的 API 来获取地理位置信息或执行相关服务。

主要功能点

本服务器提供以下主要功能（作为工具供LLM调用）：

地址转坐标: 将文字地址转换为经纬度坐标。
坐标转地址: 将经纬度坐标转换为详细地址。
地点搜索: 根据关键词搜索附近的地点或场所。
地点详情: 获取某个特定地点的详细信息（如联系方式、评分、营业时间等）。
距离矩阵: 计算多个起点和终点之间的旅行距离和时间。
海拔查询: 获取指定位置的海拔高度数据。
路线规划: 获取两个地点之间的导航路线（包括步骤、距离、时间）。

安装步骤

获取 Google Maps API Key: 访问 Google Cloud Platform 控制台，启用所需的 Google Maps Platform API（如 Geocoding API, Places API, Distance Matrix API, Elevation API, Directions API），并获取一个 API 密钥。
安装 Node.js: 确保您的系统安装了 Node.js 环境（包含 npm 或 pnpm/yarn）。
下载项目: 从 GitHub 克隆或下载本项目代码。
安装依赖: 在项目根目录运行依赖安装命令（如 'npm install', 'pnpm install', 或 'yarn install'）。或者根据 README 使用 Docker 构建镜像。

服务器配置

此 MCP 服务器需要配置在您的 MCP客户端应用 中（例如，如果您使用支持 MCP 的客户端，可能需要在其配置文件 'claude_desktop_config.json' 中添加）。

配置格式通常是一个 JSON 对象，包含：

一个顶级键 'mcpServers'，其值是一个对象，表示所有配置的MCP服务器。
在该对象内部，添加一个用于标识此 Google Maps 服务器的名称（例如 '"google-maps"'）。
该名称对应的值是一个对象，描述如何启动此服务器进程。关键字段包括：
- 'command': 启动服务器的命令（例如 '"npx"' 或 '"docker"'）。
- 'args': 传递给启动命令的参数列表。
- 'env': 一个对象，包含设置给服务器进程的环境变量。必须在此设置 'GOOGLE_MAPS_API_KEY' 环境变量，其值为您在第一步中获取的 Google Maps API Key。

请参考您的 MCP 客户端文档以获取具体的配置文件路径和格式细节。核心是将 'GOOGLE_MAPS_API_KEY' 安全地传递给服务器进程。

基本使用方法

在 MCP 客户端中完成上述配置并启动客户端后，客户端会自动发现并连接到配置的 MCP 服务器。一旦连接成功，LLM 模型即可通过 MCP 协议调用此服务器提供的 Google Maps 相关工具。例如，您可以直接在与 LLM 的对话中提出需要使用地图功能的请求，LLM 将通过调用相应的工具来完成任务。

关键词