viator-mcp

viator-mcp

Viator Partner API（v2）用のMCP サーバーです。Claude 向けにツアー、アクティビティ、体験を検索できます。構造化フィルターまたはフリーテキストでカタログを検索し、商品詳細や空き状況のスケジュールを取得したり、アトラクションや目的地を参照したりできます。すべて stdio 経由で利用できます。

AI（Claude Code）によって開発・保守されています。ご自身の判断でご利用ください。

クイックスタート

{
  "mcpServers": {
    "viator": {
      "command": "npx",
      "args": ["-y", "@chrischall/viator-mcp"],
      "env": { "VIATOR_API_KEY": "your-viator-partner-api-key" }
    }
  }
}

partnerresources.viator.com で Viator アフィリエイトに登録して、キーを取得してください。Basic Access ティアは無料です。このサーバーはこのティアを対象としており、読み取り専用の検索、コンテンツ、空き状況の確認に対応しています。予約用エンドポイントはありません（商品の結果には、アフィリエイト ID が付与された viator.com の予約用 productUrl が含まれます）。

ツール

分野	ツール
商品	vt_search_products、vt_get_product、vt_list_product_tags
検索	vt_search_freetext
アトラクション	vt_search_attractions、vt_get_attraction
空き状況	vt_get_availability_schedule
参照データ	vt_list_destinations、vt_get_locations、vt_get_exchange_rates
ヘルスチェック	vt_healthcheck — このコネクターは動作していますか？ VIATOR_API_KEY が解決されたか、Viator がキーを受け入れたか、また修正すべき点があるかを報告します。他のツールが失敗した場合は、まずここを確認してください。結果が空でも、「商品がない」場合と「認証されていない」場合があります。

すべてのツールは読み取り専用です。vt_search_products と vt_search_freetext では、完全なレコードの代わりに簡潔な要約（コード、タイトル、価格、評価、予約 URL）を返す compact: true を指定できます。

環境変数

変数	必須	説明
VIATOR_API_KEY	はい	Viator Partner API キー（exp-api-key として送信）
VIATOR_API_BASE_URL	いいえ	API ホスト（デフォルトは本番環境です。サンドボックスキーを使用する場合は https://api.sandbox.viator.com/partner を設定してください）
VIATOR_LANGUAGE	いいえ	レスポンスのテキストに使用する Accept-Language（デフォルトは en-US）
VIATOR_CACHE_TTL	いいえ	同一の読み取りをキャッシュする秒数（デフォルトは 60。0 で無効化）
VIATOR_STATIC_CACHE_TTL	いいえ	参照データ（目的地、タグ、場所、為替レート）をキャッシュする秒数（デフォルトは 3600）

Viator はローリング 10 秒間のウィンドウでエンドポイントごとにレート制限を設けており、429/503 の応答では Retry-After を返します。クライアントはこの値に従って（1 回）再試行し、レスポンスキャッシュによって同一の呼び出しの繰り返しが抑えられます。

開発

npm install
npm test          # vitest; no real network calls
npm run build     # tsc + esbuild bundle

このサーバーが準拠する API の仕様は、docs/VIATOR-API.md に固定されています。

ライセンス

MIT