Travel Planner MCP Server

🚀 旅行規劃 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 協議。