navifare-mcp

Navifare MCP サーバー

Version: 0.1.5

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（必須）: フライト区間の配列（往復旅行の場合、往路に1区間、復路に1区間）
  • travelClass（必須）: ECONOMY、PREMIUM_ECONOMY、BUSINESS、または FIRST
  • adults（必須）: 大人の乗客数（最小値: 1）
  • children（必須）: 子どもの乗客数（最小値: 0）
  • infantsInSeat（必須）: 座席が必要な幼児の人数（最小値: 0）
  • infantsOnLap（必須）: 膝上に乗せる幼児の人数（最小値: 0）
• source（必須）: クエリのソース識別子（例: "Claude"、"MCP"、"ChatGPT"）
• price（必須）: ユーザーが見つけた比較対象の価格（例: "84.00"、"200.50"）
• currency（必須）: ISO 通貨コード（3文字）（例: "EUR"、"USD"、"GBP"）
• location（必須）: ユーザーの所在地を示す ISO 国コード（2文字）（例: "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"
    }
  }
}

現在の制限事項

• 往復フライトのみ: 片道旅行にはまだ対応していません。区間が1つだけのリクエストは、直ちにエラーを返します。
• 同一の出発地・目的地: 別の空港に戻るオープンジョー旅行にはまだ対応していません。復路は、往路の到着地から出発し、往路の出発地に到着する必要があります。

レベニューシェア

条件を満たすパートナーはレベニューシェアを利用できます！

連携を通じて行われたフライト予約からコミッションを獲得できます。レベニューシェアは条件を満たすパートナーが利用できます。

コンプライアンス

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

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

環境変数

この 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 Directory への準拠に関する詳細
• 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 をご覧ください。

テストの実行

# Test with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js

# Run specific test
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 source code
├── dist/             # Compiled JavaScript (generated)
├── docs/             # Documentation
├── test/             # Test files
├── scripts/          # Helper scripts
└── [config files]    # package.json, Dockerfile, etc.

詳しい構成については、REPOSITORY_STRUCTURE.md をご覧ください。

サポート

• 一般的なお問い合わせ：[email protected]
• プライバシーに関するお問い合わせ：[email protected]
• GitHub の問題報告：https://github.com/navifare/navifare-mcp

リファレンス

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