金大哥 - Google Maps (Travel Planner) MCP 详情

article

README

🚀 旅行规划 MCP 服务器 (@gongrzhe/server-travelplanner-mcp)

这是一个与谷歌地图和旅行规划服务交互的旅行规划模型上下文协议（MCP）服务器实现。借助该服务器，大语言模型能够执行各类与旅行相关的任务，如位置搜索、地点详细信息查找以及旅行时间计算等。

🚀 快速开始

此旅行规划 MCP 服务器可助力大语言模型完成多种旅行相关任务，下面为你介绍其安装和使用方法。

📦 安装指南

使用 Smithery 安装

通过 Smithery 可自动安装 Claude 桌面版的旅行规划器：

npx -y @smithery/cli install @GongRzhe/TRAVEL-PLANNER-MCP-Server --client claude

手动安装

# 使用 npx（推荐）
npx @gongrzhe/server-travelplanner-mcp

# 配合谷歌地图 API 环境变量
GOOGLE_MAPS_API_KEY=your_api_key npx @gongrzhe/server-travelplanner-mcp

或者全局安装：

# 全局安装
npm install -g @gongrzhe/server-travelplanner-mcp

# 全局安装后运行
GOOGLE_MAPS_API_KEY=your_api_key @gongrzhe/server-travelplanner-mcp

📚 详细文档

组件

工具集

searchPlaces
- 利用谷歌 Places API 搜索地点。
- 输入：
  - query（字符串）：搜索地点的查询词。
  - location（可选）：纬度和经度以偏向结果。
  - radius（可选）：搜索半径，单位为米。
getPlaceDetails
- 获取特定地点的详细信息。
- 输入：
  - placeId（字符串）：谷歌 Places ID 用于获取详细信息。
calculateRoute
- 计算两个位置之间的路线。
- 输入：
  - origin（字符串）：起始位置。
  - destination（字符串）：结束位置。
  - mode（可选）：出行方式（驾驶、步行、骑行、transit）。
getTimeZone
- 获取某个位置的时间区信息。
- 输入：
  - location：纬度和经度坐标。
  - timestamp（可选）：用于计算时区的时间戳。

配置

与 Claude 桌面版一起使用

要在 Claude 桌面版应用中使用此服务器，请在 claude_desktop_config.json 的 "mcpServers" 部分添加以下配置：

{
  "mcpServers": {
    "travel-planner": {
      "command": "npx",
      "args": ["@gongrzhe/server-travelplanner-mcp"],
      "env": {
        "GOOGLE_MAPS_API_KEY": "your_google_maps_api_key"
      }
    }
  }
}

或者，若你直接使用 node 命令：

{
  "mcpServers": {
    "travel-planner": {
      "command": "node",
      "args": ["path/to/dist/index.js"],
      "env": {
        "GOOGLE_MAPS_API_KEY": "your_google_maps_api_key"
      }
    }
  }
}

开发

从源代码构建

克隆仓库。
安装依赖：

npm install

构建项目：

npm run build

环境变量

GOOGLE_MAPS_API_KEY（必需）：具有以下 API 接口启用的谷歌地图 API 密钥：
- 地图数据 API
- 地理编码 API
- 距离矩阵 API
- 街景图像 API

📄 许可证

MIT

Google Maps (Travel Planner)