Travel Planner MCP 服务器 (@gongrzhe/server-travelplanner-mcp)

一个用于与 Google Maps 和旅行规划服务交互的 Travel Planner Model Context Protocol (MCP) 服务器实现。 此服务器使 LLM 能够执行与旅行相关的任务，例如位置搜索、地点详细信息查找和旅行时间计算。

<a href="https://glama.ai/mcp/servers/y3u6yjiiq1"> <img width="380" height="200" src="https://glama.ai/mcp/servers/y3u6yjiiq1/badge" alt="Travel Planner Server MCP server" /> </a>

安装与使用

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Travel Planner，请执行以下操作：

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 (string)：地点搜索查询
    • location (optional)：用于偏向结果的纬度和经度
    • radius (optional)：搜索半径（米）

• getPlaceDetails

  • 获取有关特定地点的详细信息
  • 输入：
    • placeId (string)：要检索详细信息的 Google Place ID

• calculateRoute

  • 计算两个位置之间的路线
  • 输入：
    • origin (string)：起始位置
    • destination (string)：结束位置
    • mode (optional)：出行方式（driving、walking、bicycling、transit）

• getTimeZone

  • 获取位置的时区信息
  • 输入：
    • location：纬度和经度坐标
    • timestamp (optional)：用于时区计算的时间戳

配置

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

或者，如果已安装该软件包，则可以直接使用 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 (必需)：您的 Google Maps API 密钥，并启用以下 API：
  • Places API
  • Directions API
  • Geocoding API
  • Time Zone API

许可证

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