旅行规划服务

一个基于Google Maps的旅行规划服务器,提供地点搜索、路线计算和时区查询等功能,适用于LLMs进行旅行相关任务。

  • by GongRzhe
  • JavaScript
  • 本地部署
  • 98 星标
  • 更新于
在 GitHub 查看 GongRzhe/TRAVEL-PLANNER-MCP-Server

使用说明

旅行计划器MCP服务器(@gongrshe/Server travelplanner MCP)

用于与谷歌地图和旅行计划服务交互的旅行计划器模型上下文协议(MCP)服务器实现。此服务器使LLM能够执行与旅行相关的任务,如位置搜索、地点详细信息查找和旅行时间计算。

安装与使用

通过Smithery安装

通过以下方式自动安装克劳德桌面旅行计划器 史密瑟里:

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

手动安装

# Using npx (recommended)
npx @gongrzhe/server-travelplanner-mcp

# With environment variable for Google Maps API
GOOGLE_MAPS_API_KEY=your_api_key npx @gongrzhe/server-travelplanner-mcp

或全局安装:

# Install globally
npm install -g @gongrzhe/server-travelplanner-mcp

# Run after global installation
GOOGLE_MAPS_API_KEY=your_api_key @gongrzhe/server-travelplanner-mcp

组件

工具

  • 搜索地点

    • 使用Google places API搜索地点
    • 输入:
      • query (string):地点搜索查询
      • location (可选):纬度和经度会影响结果
      • radius (可选):搜索半径(单位:米)
  • getPlaceDetails

    • 获取特定地点的详细信息
    • 输入:
      • placeId (string):用于检索详细信息的Google Place ID
  • calculateRoute

    • 计算两个地点之间的路线
    • 输入:
      • origin (string):起始位置
      • destination (string):结束位置
      • mode (可选):旅行方式(驾驶、步行、骑自行车、公交)
  • 获取时区

    • 获取某个位置的时区信息
    • 输入:
      • location:经纬度坐标
      • timestamp (可选):时区计算的时间戳

配置

使用Claude Desktop

要将此服务器与Claude Desktop应用程序一起使用,请将以下配置添加到您的“mcpServers”部分 claude_desktop_config.json:

{
  "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"
      }
    }
  }
}

发展

从源头构建

  1. 克隆存储库
  2. 安装依赖项:
    npm install
    
  3. 构建项目:
    npm run build
    

环境变量

  • GOOGLE_MAPS_API_KEY (必需):启用了以下API的Google Maps API密钥:
    • 地点API
    • API指南
    • 地理编码API
    • API时区

许可证

此MCP服务器根据MIT许可证获得许可。有关更多详细信息,请参阅项目存储库中的LICENSE文件。