Navifare MCP

🚀 Navifare MCP Server

Navifareは、ユーザーが既に見つけた特定のフライトについて、より安い価格を見つけます。ユーザーは会話形式でフライトの詳細を提供すると、必要な形式に構造化されます。

🚀 クイックスタート

このMCPサーバーは、NavifareのREST APIをフライト価格比較用のMCPツールとしてラップしています。ClaudeなどのAIアシスタントが、ユーザーが既に見つけたフライトのより安い価格を見つけるのを支援できるようになります。

✨ 主な機能

MCPエンドポイント

• 本番環境: https://mcp.navifare.com/mcp
• ドキュメント: https://www.navifare.com/mcp (MCPエンドポイントから自動更新)
• MCPについて詳しく学ぶ: Model Context Protocol

ツール

format_flight_pricecheck_request

タイトル: フライトリクエストのフォーマット

自然言語テキストまたは画像の文字起こし内容からフライトの詳細を解析し、フォーマットします。フライト情報（航空会社、フライト番号、日付、空港、価格）を抽出し、価格比較用に構造化します。flight_pricecheckに使用できるフォーマット済みのフライトデータを返すか、情報が不足している場合は不足情報を要求します。

注釈:

• readOnlyHint: true - ツールはデータのフォーマット/解析のみを行い、外部呼び出しは行いません
• destructiveHint: false - ツールはデータを変更または削除しません

入力スキーマ:

• user_request (必須): 自然言語テキストでのフライト詳細。利用可能なすべての情報を含めてください: フライト番号、航空会社、出発/到着空港と時刻、日付、価格、搭乗者数、旅行クラス。

リクエスト例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "format_flight_pricecheck_request",
    "arguments": {
      "user_request": "I found an Aeroitalia flight XZ2020 from FCO to MXP leaving tomorrow at 19.31 and returning with XZ2021 MXP to FCO next Friday at 10.11. 1 adult, economy, the best fare was 221 EUR"
    }
  }
}

flight_pricecheck

タイトル: フライト価格チェック

ユーザーが既に見つけた特定のフライトについて、複数の予約ソースを検索して、より安い価格を見つけます。異なる予約プラットフォーム間で価格を比較し、まったく同じフライト詳細について安い代替案を見つけます。

注釈:

• readOnlyHint: false - ツールは検索を実行し、外部API呼び出しをトリガーする可能性があります
• destructiveHint: false - ツールはデータを変更または削除しません

入力スキーマ:

• trip (必須): フライトの旅程詳細。セグメント、搭乗者、旅行クラスを含みます。
  • legs (必須): フライトの区間の配列（往復の場合は往路と復路）
  • travelClass (必須): ECONOMY、PREMIUM_ECONOMY、BUSINESS、またはFIRST
  • adults (必須): 大人の搭乗者数（最小: 1）
  • children (必須): 子供の搭乗者数（最小: 0）
  • infantsInSeat (必須): 座席を必要とする乳幼児の数（最小: 0）
  • infantsOnLap (必須): 保護者の膝上にいる乳幼児の数（最小: 0）
• source (必須): クエリのソース識別子（例: "Claude", "MCP", "ChatGPT"）
• price (必須): ユーザーが見つけた基準価格（例: "84.00", "200.50"）
• currency (必須): 3文字のISO通貨コード（例: "EUR", "USD", "GBP"）
• location (必須): ユーザーの所在地の2文字のISO国コード（例: "ES", "IT", "US"）。不明な場合は、"ZZ" をデフォルトとします。

リクエスト例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "flight_pricecheck",
    "arguments": {
      "trip": {
        "legs": [
          {
            "segments": [
              {
                "airline": "XZ",
                "flightNumber": "2020",
                "departureAirport": "MXP",
                "arrivalAirport": "FCO",
                "departureDate": "2025-12-16",
                "departureTime": "07:10",
                "arrivalTime": "08:25",
                "plusDays": 0
              }
            ]
          }
        ],
        "travelClass": "ECONOMY",
        "adults": 1,
        "children": 0,
        "infantsInSeat": 0,
        "infantsOnLap": 0
      },
      "source": "MCP",
      "price": "84",
      "currency": "EUR",
      "location": "IT"
    }
  }
}

🔧 技術詳細

現在の制限事項

• 往復フライトのみ: 片道旅行はまだサポートされていません。単一の区間のリクエストはすぐにエラーを返します。
• 同一の出発地/目的地: オープンジョー旅行（異なる空港に戻る）はまだサポートされていません。復路のフライトは、往路の目的地から出発し、往路の出発地に到着する必要があります。

収益分配

適格なパートナーには収益分配が可能です！

あなたの統合を通じて行われたフライト予約に対してコミッションを獲得できます。適格なパートナーには収益分配が可能です。

コンプライアンス

このサーバーは、AnthropicのMCPディレクトリポリシーに準拠しています。詳細は docs/COMPLIANCE.md を参照してください。

プライバシーポリシーと利用規約: https://navifare.com/terms
お問い合わせ: contact@navifare.com
プライバシーに関する問い合わせ: privacy@navifare.com

環境変数

このMCPサーバーについて通常ドキュメント化する必要がある唯一の環境変数は次の通りです。

• GEMINI_API_KEY (必須): 自然言語解析用のGoogle Gemini APIキー（あなたの統合がテキスト/画像理解にGeminiに依存する場合に使用）。

例

詳細なワークフローを含む完全な使用例については、docs/USAGE_EXAMPLES.md を参照してください。

ドキュメント

ほとんどのドキュメントは docs/ ディレクトリにあります（この README.md や REPOSITORY_STRUCTURE.md などのいくつかのファイルはリポジトリのルートにあります）。

始めるには

• docs/QUICKSTART.md - 5分で始めるガイド
• docs/LOCAL_DEPLOYMENT.md - 詳細なローカルデプロイメントガイド
• docs/RENDER_DEPLOYMENT_GUIDE.md - 本番デプロイメントガイド

リファレンス

• docs/COMPLIANCE.md - Anthropic MCPディレクトリのコンプライアンス詳細
• docs/USAGE_EXAMPLES.md - 完全な使用例
• docs/CLAUDE_SUBMISSION_CHECKLIST.md - Claude提出チェックリスト
• REPOSITORY_STRUCTURE.md - リポジトリの構成

追加ガイド

• docs/NGROK_SETUP.md - ローカルテスト用のngrokセットアップ
• docs/IMAGE_INPUT_GUIDE.md - 画像処理ガイド

テスト

テストファイルは test/ ディレクトリにあります。利用可能なテストの詳細については、test/README.md を参照してください。

テストの実行

# MCPインスペクターでテスト
npx @modelcontextprotocol/inspector node dist/index.js

# 特定のテストを実行
node test/test-mcp.js

スクリプト

ヘルパースクリプトは scripts/ ディレクトリにあります。

• scripts/start-local.sh - ローカル開発サーバーを起動
• scripts/deploy-to-render.sh - Renderデプロイメントの準備
• scripts/start-servers.sh - 複数のサーバーを起動
• scripts/stop-servers.sh - 実行中のサーバーを停止

リポジトリ構造

navifare-mcp/
├── src/              # TypeScriptソースコード
├── dist/             # コンパイルされたJavaScript（生成される）
├── docs/             # ドキュメント
├── test/             # テストファイル
├── scripts/          # ヘルパースクリプト
└── [config files]    # package.json, Dockerfile, etc.

詳細な構造については REPOSITORY_STRUCTURE.md を参照してください。

サポート

• 一般的な問い合わせ: contact@navifare.com
• プライバシーに関する問い合わせ: privacy@navifare.com
• GitHubの問題: https://github.com/navifare/navifare-mcp

参照

• MCPドキュメント
• REST APIからMCPサーバーへ