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 服务器