navifare-mcp

Navifare MCP Server

版本：0.1.5

Navifare 可以为用户已经找到的特定航班寻找更优惠的价格。用户应以对话方式提供航班详情，系统会将其整理为所需格式。

概览

此 MCP 服务将 Navifare REST API 封装为用于比较航班价格的 MCP 工具。它使 Claude 等 AI 助手能够帮助用户为已找到的航班寻找更优惠的价格。

MCP 端点

• 生产环境：https://mcp.navifare.com/mcp
• 文档：https://www.navifare.com/mcp（从 MCP 端点自动更新）
• 了解有关 MCP 的更多信息：模型上下文协议

工具

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（必填）：三字母 ISO 货币代码（例如，“EUR”、“USD”、“GBP”）
• location（必填）：用户所在位置的两字母 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 Directory Policy。详情请参阅 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 服务