wander-agent

pip install wander-agent

インストールしたら、すぐにこれらを試してみてください — どれかをAIに貼り付けてください：

• 🛫 「航空会社が見せたくない、NYCから東京へのフライトを見つけて。」 → OTAでは表示が禁止されている隠れ都市便と分割発券の運賃
• 🌴 「9月にドバイ発で2人、予算3,000ドルのバリ島10日間旅行を計画して。」 → 航空券、ホテル、ビザ、天気、レストラン、持ち物リスト、日ごとの旅程を一度に回答
• 🛂 「私の2つのパスポートのうち、ビザなしで入国できる国が多いのはどちら？」 → ヘンリー・パスポート・インデックスのランキング付きで、2つのパスポートを比較
• 💳 「Amexポイントをヨーロッパ行きの最もお得なビジネスクラス航空券に使って。」 → ポイント移行先を横断して、お得な使い道を検索

これは何ですか？

Wander Agentは、AIアシスタント（Claude、Cursor、Windsurfなど）向けのツールプラグインで、AIが実際の旅行データを利用できるようにします。

このプラグインがない状態でAIに「8月のニューヨーク発東京行きで最安の航空券は？」と尋ねると、作り話の回答が返ってきます。このプラグインを使えば、AIはGoogle Flights、Open-Meteo、米国国務省の渡航勧告、OpenStreetMapなどの実際のデータソースを参照し、実際の価格、正確な天気予報、最新のビザ要件を提示します。

いつもどおりAIに話しかけるだけです。あとはAIにお任せください。

「9月にドバイ発で2人、予算3,000ドルのバリ島10日間旅行を計画して」 → 実際の航空券とホテル、ビザ要件、天気予報、現地のレストラン、持ち物リスト、日ごとの旅程をすべて一度に回答します。

何ができますか？

セットアップ（5分）

ステップ1 — Pythonをインストールする

Python 3.10以降が必要です。インストール済みか確認してください：

python3 --version

インストールされていない場合は、python.orgからダウンロードしてください。

ステップ2 — Wander Agentをインストールする

PyPIからインストールします（推奨）：

pip install wander-agent

または、uvを使えばインストールは不要で、そのまま実行できます：

uvx wander-agent

または、ソースからインストールします：

git clone https://github.com/VirajMishra1/wander-agent.git
cd wander-agent
pip install -e .

正しく動作することを確認します：

wander-agent --help

ステップ3 — AIに接続する

使用するアプリを選んでください：

{
  "mcpServers": {
    "wander-agent": {
      "command": "wander-agent"
    }
  }
}

which wander-agent

{
  "mcpServers": {
    "wander-agent": {
      "command": "/usr/local/bin/wander-agent"
    }
  }
}

claude mcp add wander-agent wander-agent

claude mcp list

{
  "mcpServers": {
    "wander-agent": {
      "command": "wander-agent"
    }
  }
}

{
  "mcpServers": {
    "wander-agent": {
      "command": "wander-agent"
    }
  }
}

{
  "mcpServers": {
    "wander-agent": {
      "command": "wander-agent"
    }
  }
}

{
  "mcpServers": [
    {
      "name": "wander-agent",
      "command": "wander-agent"
    }
  ]
}

{
  "context_servers": {
    "wander-agent": {
      "command": {
        "path": "wander-agent",
        "args": []
      }
    }
  }
}

オプション：より充実したデータを利用するための API キー

API キーがなくてもすべての機能を利用できます。必要に応じて設定すると、より充実したデータを取得できます。

AI の起動前に設定してください。

export FOURSQUARE_API_KEY=your_key_here
export TICKETMASTER_API_KEY=your_key_here

または、シェルのプロファイル（~/.zshrc、~/.bashrc）に追加すると、永続的に設定できます。

全 75 種類のツール

✈️ フライト

🏨 ホテル

📋 ビザと入国

🌤️ 天気

⚠️ 安全とニュース

💰 費用と通貨

🗺️ 計画とスコアリング

🍜 食事とナイトライフ

🌐 スマート旅行ツール

🎒 現地で役立つ情報

🏛️ 観光スポットと情報

🧠 旅行者プロフィール

🧳 保存した旅行（セッションをまたいで記憶）

~/.wander_agent/trips.json に保存されます。旅行には、8 項目の予約チェックリスト（航空券、ホテル、ビザ、保険、現地交通、渡航情報、荷造り、銀行への連絡）が付属します。

🔔 運賃のウォッチ

~/.wander_agent/fare_watches.json に保存されます。監視対象のルートごとに基準価格と価格履歴を記録します。

⚖️ 価値のランキング

💳 クレジットカードのポイントとマイル

20のロイヤルティプログラム（Chase UR、Amex MR、Citi TYP、Capital One、Bilt、11の航空会社、4つのホテルチェーン）、ボーナスカテゴリー付きの人気クレジットカード9枚、厳選されたお得な特典航空券・宿泊特典10件を網羅した静的データセットです。カードの保有状況は ~/.wander_agent/profile.json に保存されます。

ツールのランキング：実用性 × 独自性

実用面での効果と独自性を組み合わせて順位付けしています。OTAにもチャットボットにも、ほかの旅行ツールにもできないことを基準にしています。

データソース

各数値の信頼性はどの程度ですか？

多くの結果には data_meta ブロックが含まれており、予約前に数値の信頼性をAIが判断できます。

"data_meta": {
  "confidence": "scraped_live",
  "trust_score": 80,
  "trust_label": "Live scrape",
  "meaning": "Scraped from Google Flights just now. Real but can shift minute to minute.",
  "fetched_at": "2026-06-02T18:30:00+00:00",
  "source": "google_flights + kiwi.com"
}

正直な制限事項

航空券の価格： Google Flights スクレイパーは、Google がページ構造を変更すると動作しなくなることがあります。Kiwi の価格は実際に予約可能なものです。両方を並行して実行するため、一方が失敗しても、もう一方から結果が返されます。

乗り継ぎを別切りの航空券にするリスク： find_split_ticket は実際に節約できる金額を提示しますが、乗り継ぎに間に合わないリスクがあります。最初のフライトが遅延しても、2便目の航空会社は待ってくれず、予約の取り直しにも応じません。このツールは常に、リスクに関する完全な説明を返します。別切りの航空券での乗り継ぎ失敗を補償する旅行保険に加入してください。

ホテル料金： ホテル料金 API はすべて有料です。このツールはホテル名と、実際の料金を確認できる 9 つの予約サイトへのリンクを返します。料金は直接表示されません。

ビザ情報： 静的スナップショット（2024 年更新）です。規定は変更されるため、予約の前に必ず回答内の公式リンクで確認してください。入国に関する判断には、この情報を頼らないでください。

トランジットビザ情報： 200 を超える組み合わせを網羅した静的データセットに規則を記録しています。例外的なケース（二国間の免除措置がある国籍、最近の規定変更など）は含まれていない場合があります。必ず航空会社または渡航先の大使館に確認してください。

パスポートの強さに関する情報： Henley Index 2024 のスナップショットです。ランキングは年ごとに変動します。国籍に基づく判断をする前に、必ず公式情報源で確認してください。

SIM カード情報： 2024 年第 4 四半期時点の厳選したスナップショットです。価格やプランは頻繁に変わります。あくまで参考情報として扱い、購入前に確認してください。

イベント： Eventbrite からスクレイピングしています。今後 0〜60 日のイベントを最もよく網羅しています。それより先のイベントは、まだ掲載されていない場合があります。

渡航勧告： 米国国務省の情報のみです。公式発表の変更から 24〜48 時間以内に、RSS 経由で更新されます。

健康情報： CDC Yellow Book および WHO の 2024〜2025 年の推奨事項に基づく、厳選したスナップショットです。渡航医学クリニックでの助言に代わるものではありません。

地上交通： 経路の検索には Rome2Rio のデータを使用しています。実際の料金と時刻表は予約サイトで確認してください。所要時間や運賃は変わります。

ポイント／マイルの価値： 基準となる cpp の値は、TPG、NerdWallet、OMAAT の編集上の平均値です。実際の交換価値は、特典航空券の空席状況、ポイント移行ボーナス、変動価格制によって異なります。お得な交換先は、セーバー相当の空席があることを前提としています。カードのボーナスカテゴリーは 2025 年第 1 四半期時点の規約に基づいています。発行会社はこれらを定期的に変更します。

炭素排出量の計算： ICAO／DEFRA の 2024 年排出係数に、標準的な RFI 乗数（×1.9）を適用しています。実際の排出量は、機種、搭乗率、経路によって異なります。会計上の数値ではなく、推定値としてご利用ください。

クラウドへのデプロイ（Docker）

付属の Dockerfile と railway.toml を使うと、このサーバーをクラウドでホストでき、インストールしたコンピューター以外のデバイスからも接続できます。

通常のローカル利用では必要ありません。 上記のセットアップ手順に従って、ローカルにインストールして実行してください。

Railway でセルフホストする場合：

# Push to GitHub, then connect repo to Railway
# Set env vars in Railway dashboard if using optional API keys

サーバーは WANDER_TRANSPORT 環境変数に基づいて、stdio（ローカル）から HTTP に自動で切り替わります。

開発

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
python -m pytest tests/ -v

# Count registered tools
grep -c "@mcp.tool()" src/wander_agent/server.py

ツールの追加：

1. 非同期関数を含む src/wander_agent/tools/your_tool.py を作成します
2. src/wander_agent/server.py にインポートします
3. @mcp.tool() と非同期ラッパー関数でラップします
4. 新しいツールを読み込むため、AI クライアントを再起動します

CI： main へのプッシュと PR のたびに、Python 3.10／3.11／3.12 でテストスイートを実行し、登録済みツールの数を検証します。

リリース： GitHub リリースを公開すると、PyPI への公開ワークフローが実行されます（トラステッドパブリッシングを使用するため、トークンは不要です）。まず pyproject.toml と server.json の version を更新してください。

ライセンス

MIT

mcp-name: io.github.VirajMishra1/wander-agent