Google Maps (Travel Planner)

🚀 旅行规划 MCP サーバー (@gongrzhe/server-travelplanner-mcp)

このサーバーは、Googleマップと旅行計画サービスとやり取りする旅行計画モデルコンテキストプロトコル（MCP）サーバーの実装です。大規模言語モデルが旅行関連のタスク、例えば場所の検索、場所の詳細情報の取得、旅行時間の計算などを実行できるようにします。

🚀 クイックスタート

📦 インストール

Smitheryを使用したインストール

Smitheryを通じて、Claudeデスクトップ版の旅行計画ツールを自動的にインストールできます。

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

手動インストール

# npxを使用する（推奨）
npx @gongrzhe/server-travelplanner-mcp

# Googleマップ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

💻 使用例

基本的な使用法

サーバーを起動して、大規模言語モデルから旅行関連のタスクを実行できます。以下は、基本的なコマンドの例です。

npx @gongrzhe/server-travelplanner-mcp

✨ 主な機能

ツールセット

• searchPlaces
  • Google Places APIを使用して場所を検索します。
  • 入力:
    • query (文字列)：場所を検索するためのクエリ
    • location (オプション)：結果を偏らせるための緯度と経度
    • radius (オプション)：検索半径（メートル）
• getPlaceDetails
  • 特定の場所の詳細情報を取得します。
  • 入力:
    • placeId (文字列)：詳細情報を取得するためのGoogle Places ID
• calculateRoute
  • 2つの場所間の経路を計算します。
  • 入力:
    • origin (文字列)：出発地
    • destination (文字列)：目的地
    • mode (オプション)：移動手段（自動車、徒歩、自転車、公共交通機関）
• getTimeZone
  • 特定の場所のタイムゾーン情報を取得します。
  • 入力:
    • location：緯度と経度の座標
    • timestamp (オプション)：タイムゾーンを計算するためのタイムスタンプ

📚 ドキュメント

設定

Claudeデスクトップ版との連携

Claudeデスクトップ版アプリでこのサーバーを使用するには、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（必須）：以下のAPIが有効になっているGoogleマップAPIキーです。
  • マップデータAPI
  • ジオコーディングAPI
  • 距離行列API
  • ストリートビュー画像API

📄 ライセンス

MIT