Navifare MCP

🚀 Navifare MCP Server

Navifare 能夠為用戶已找到的特定航班找到更優惠的價格。用戶只需以對話方式提供航班詳細信息，系統會將其整理成所需格式。

🚀 快速開始

Navifare MCP 服務器將 Navifare REST API 封裝為 MCP 工具，用於航班價格比較。它使 Claude 等 AI 助手能夠幫助用戶為已發現的航班找到更優惠的價格。

✨ 主要特性

• 封裝 Navifare REST API 為 MCP 工具，便於 AI 助手使用。
• 支持自然語言解析航班信息，方便用戶輸入。
• 可搜索多個預訂源，為用戶找到更優惠的航班價格。

📦 安裝指南

文檔未提及安裝步驟，故跳過此章節。

💻 使用示例

基礎用法

format_flight_pricecheck_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

{
  "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"
    }
  }
}

📚 詳細文檔

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（必需）：自然語言文本形式的航班詳細信息。包括所有可用信息：航班號、航空公司、出發/到達機場和時間、日期、價格、乘客數量和旅行艙位。

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（必需）：三位 ISO 貨幣代碼（例如，"EUR"、"USD"、"GBP"）。
• location（必需）：用戶所在國家的兩位 ISO 代碼（例如，"ES"、"IT"、"US"）。如果不確定，默認為 "ZZ"。

文檔目錄

大部分文檔位於 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 - 圖像處理指南

🔧 技術細節

文檔未提及技術實現細節，故跳過此章節。

📄 許可證

文檔未提及許可證信息，故跳過此章節。

當前限制

• 僅支持往返航班：目前不支持單程航班。單航段請求將立即返回錯誤。
• 相同出發/目的地：目前不支持開口航班（返回不同機場）。返程航班必須從去程目的地出發，併到達去程出發地。

收益分成

合格合作伙伴可享受收益分成！ 通過您的集成進行的航班預訂可獲得佣金。合格合作伙伴可享受收益分成。

合規性

此服務器符合 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。

測試

測試文件位於 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/          # 輔助腳本
└── [配置文件]        # package.json、Dockerfile 等

有關詳細結構，請參閱 REPOSITORY_STRUCTURE.md。

支持

• 一般諮詢：contact@navifare.com
• 隱私諮詢：privacy@navifare.com
• GitHub 問題：https://github.com/navifare/navifare-mcp

參考

• MCP 文檔
• 從 REST API 到 MCP 服務器