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

  • 2つの位置間の経路を計算します。
  • 入力:
    • origin (文字列): 出発地
    • destination (文字列): 目的地
    • mode (オプション): 移動手段（自動車、徒歩、自転車、公共交通機関）

• 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 ライセンスの下で提供されています。