Travel Planner MCP Server (@gongrzhe/server-travelplanner-mcp)

基本能力

产品定位

Travel Planner MCP Server 是一个专门用于旅行规划和位置服务的MCP服务器，通过与Google Maps API的集成，提供丰富的地理位置和旅行相关功能。

核心功能

1. 位置搜索（searchPlaces）：使用Google Places API搜索地点，支持查询、位置偏置和搜索半径设置。
2. 地点详情查询（getPlaceDetails）：获取特定地点的详细信息，需要提供Google Place ID。
3. 路线计算（calculateRoute）：计算两个地点之间的路线，支持多种出行模式（如驾车、步行、骑行和公共交通）。
4. 时区查询（getTimeZone）：获取指定位置的时区信息，支持特定时间戳的时区计算。

适用场景

1. 旅行规划：帮助用户规划旅行路线，计算旅行时间。
2. 地点搜索：快速查找附近的地点或特定查询的地点。
3. 时区管理：获取特定位置的时区信息，便于跨时区行程安排。

工具列表

1. searchPlaces：通过Google Places API搜索地点。
2. getPlaceDetails：获取特定地点的详细信息。
3. calculateRoute：计算两个地点之间的路线。
4. getTimeZone：获取指定位置的时区信息。

常见问题解答

1. 如何获取Google Maps API Key？：需要在Google Cloud Platform中启用Places API、Directions API、Geocoding API和Time Zone API。
2. 如何配置Claude Desktop使用此服务？：需要在claude_desktop_config.json中添加相应的MCP服务器配置。

使用教程

使用依赖

1. Node.js：确保已安装Node.js环境。
2. Google Maps API Key：需要有效的Google Maps API Key。

安装教程

通过Smithery安装

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

手动安装

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

# 使用环境变量设置Google Maps API Key
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

调试方式

1. 检查环境变量：确保GOOGLE_MAPS_API_KEY已正确设置。
2. 运行服务：使用上述安装命令启动服务，检查是否有错误输出。
3. 测试工具：通过Claude Desktop或其他MCP客户端测试各工具功能是否正常。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。