微信扫一扫README
🚀 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