🚀 旅行规划 MCP 服务器 (@gongrzhe/server-travelplanner-mcp)
这是一个与 Google Maps 和旅行规划服务交互的旅行规划模型上下文协议 (MCP) 服务器实现。它能让大型语言模型 (LLMs) 执行旅行相关任务，如位置搜索、地点详细信息查找和旅行时间计算。
🚀 快速开始
本服务器可助力大型语言模型处理各类旅行相关任务，以下为您介绍安装与使用方法。
📦 安装指南
使用 Smithery 安装
通过 Smithery 可自动安装 Claude Desktop 的旅行规划器：
npx -y @smithery/cli install @GongRzhe/TRAVEL-PLANNER-MCP-Server --client claude
手动安装
# 使用 npx（推荐）
npx @gongrzhe/server-travelplanner-mcp
# 配合环境变量使用 Google Maps 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
- 功能：使用 Google Places API 搜索地点。
- 输入：
query(字符串)：搜索地点的查询词。location(可选)：经纬度以偏向结果。radius(可选)：搜索半径（单位：米）。
-
getPlaceDetails
- 功能：获取特定地点的详细信息。
- 输入：
placeId(字符串)：Google 地点 ID，用于检索详细信息。
-
calculateRoute
- 功能：计算两个位置之间的路线。
- 输入：
origin(字符串)：起始位置。destination(字符串)：结束位置。mode(可选)：出行方式（驾驶、步行、骑行、 transit）。
-
getTimeZone
- 功能：获取位置的时间区信息。
- 输入：
location：经纬度坐标。timestamp(可选)：用于计算时区的时间戳。
📚 详细文档
配置
与 Claude Desktop 结合使用
要在 Claude Desktop 应用中使用此服务器，请在 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"
}
}
}
}
开发
源代码构建
- 克隆仓库：
git clone https://github.com/yourusername/your-repository.git cd your-repository - 安装依赖项：
npm install - 运行服务器：
npm start
环境变量
# 必要的环境变量示例
GOOGLE_MAPS_API_KEY=your_api_key_here
📄 许可证
此项目遵循 LICENSE 协议。