TravelAgentMCP 🌍✈️

一个用于 TVA OTA 平台的 MCP（模型上下文协议）服务器单体仓库：提供航班和酒店搜索与预订、签证和移民要求及预订跟踪、以及用户账户管理——专为 AI 旅行代理构建。

架构

TravelAgentMCP/
├── mcps/
│   ├── shared/            @travelagent-mcp/shared — HTTP client, config, guardrails, tool helper (not a server)
│   ├── flight-mcp/        tva-flight-mcp   — search, pricing, seatmaps, booking lifecycle
│   ├── hotel-mcp/         tva-hotel-mcp    — search, availability, booking lifecycle
│   ├── visa-mcp/          tva-visa-mcp     — country requirements + booking tracking
│   ├── immigration-mcp/   tva-immigration-mcp — service info + booking tracking
│   └── account-mcp/       tva-account-mcp  — auth, profile, promo codes, notifications
└── src/index.ts           travelagent-mcp  — gateway that mounts all five servers' tools in one process

每个 mcps/* 包都是一个独立可运行的 stdio MCP 服务器，带有自己的 bin。运行你需要的那些（例如，仅 tva-flight-mcp + tva-hotel-mcp 用于预订小部件，或仅 tva-visa-mcp + tva-immigration-mcp 用于咨询机器人），或运行根网关（travelagent-mcp）以在一个进程中获取所有功能——这就是已发布的 npm 包一直以来的形式，为向后兼容而保留。

一个上游 API，两种认证模式：

• TVA OTA 后端（TVA_BASE_URL）——航班、酒店、预订、账户，以及签证/移民预订跟踪的“客户端”侧（更新、通知、交易）。大多数预订管理端点需要 bearer 令牌；访客结账流程（预订、按 UUID 取消、验证、重新发送票据）则不需要。

• 签证/移民内容（相同的 TVA_BASE_URL，通过 CONTENT_API_KEY 而非 bearer 令牌认证）——国家要求、签证类型、费用和常见问题解答，仅由 GET_VISA_INFO_BY_COUNTRY / GET_IMMIGRATION_INFO_BY_COUNTRY 使用。

Related MCP server: orizn-visa-mcp

防护措施

• 最小权限：仅暴露面向用户的端点。管理/运营端点（预订管理、退款、收入统计）故意不包装为工具——它们不适合对话式代理。

• 明确确认：每个涉及资金流动或不可逆的工具（BOOK_FLIGHT、BOOK_HOTEL、CANCEL_FLIGHT_BOOKING、CANCEL_HOTEL_BOOKING、CONFIRM_FLIGHT_PAYMENT、CONFIRM_HOTEL_PAYMENT、SELECT_FLIGHT_SEAT、CHANGE_PASSWORD、CLOSE_ACCOUNT）都需要 confirm: true，调用代理应在向用户回读具体细节后才设置此参数。

• LLM 上下文中无秘密：TVA_ACCESS_TOKEN 绝不是工具参数——它从进程环境中读取，由生成这些服务器的任何代理按用户会话注入。LOGIN_USER / SOCIAL_AUTH_LOGIN 将令牌包装在 __session 信封中返回，供生成代理拦截并带外存储；模型仅看到一条纯确认消息。请参阅 mcps/account-mcp/src/lib/session.ts 了解约定。

• 无原始报价重放：Amadeus 航班报价是大型不透明 JSON 块。SEARCH_FLIGHTS 将每个报价缓存在服务器端（SQLite，请参阅 mcps/flight-mcp/src/lib/offerCache.ts），并向模型提供一个简短的 offerRef——模型永远不会手动重建报价 JSON，这可能会带来令牌膨胀或价格/费用静默损坏的风险。

• 脱敏：密码、令牌、OTP 和卡号在记录任何内容之前都会被屏蔽（请参阅 mcps/shared/src/guardrails.ts）。

• 已知风险——酒店支付：BOOK_HOTEL 当前直接接收原始卡详细信息（TVA 酒店 API 尚无令牌化结账步骤）。这必须仅由通过符合 PCI 标准的表面收集了卡详细信息的客户端调用——绝不能通过提示用户在聊天中键入卡号来调用。请参阅工具描述了解详情。

• 速率限制：每个工具调用按进程进行节流（防止失控的函数调用循环）。这不能替代持久的、跨轮次的节流——如果你需要真正的保护，请在会话层持久跟踪滥用情况。

设置

pnpm install
cp .env.example .env   # fill in TVA_BASE_URL and content-API keys
pnpm build              # builds mcps/shared first, then every domain server, then the gateway

运行网关（一个进程中的所有工具）：

pnpm start

或直接运行单个域服务器：

node mcps/flight-mcp/dist/index.js

工具参考

航班（tva-flight-mcp）

SEARCH_FLIGHTS、GET_POPULAR_FLIGHT_ROUTES、GET_FLIGHT_PRICE_ANALYSIS、GET_MOST_TRAVELED_DESTINATIONS、GET_MOST_BOOKED_DESTINATIONS、GET_BUSIEST_TRAVEL_PERIOD、GET_FLIGHT_SEATMAP_BY_OFFER、GET_FLIGHT_SEATMAP_BY_ORDER、GET_FLIGHT_FARE_UPSELL、PREDICT_FLIGHT_CHOICE、CONFIRM_FLIGHT_PRICE、BOOK_FLIGHT、LIST_MY_FLIGHT_BOOKINGS、GET_FLIGHT_BOOKING、VERIFY_FLIGHT_BOOKING、CANCEL_FLIGHT_BOOKING、GET_FLIGHT_SEAT_PRICE、SELECT_FLIGHT_SEAT、RESEND_FLIGHT_TICKET、GET_FLIGHT_TICKET_DOWNLOAD_LINK、CONFIRM_FLIGHT_PAYMENT

酒店（tva-hotel-mcp）

SEARCH_HOTELS、SEARCH_HOTEL_CITIES、CHECK_HOTEL_AVAILABILITY、BOOK_HOTEL、LIST_MY_HOTEL_BOOKINGS、GET_HOTEL_BOOKING、CONFIRM_HOTEL_PAYMENT、CANCEL_HOTEL_BOOKING

签证（tva-visa-mcp）

GET_VISA_INFO_BY_COUNTRY、LIST_MY_VISA_BOOKINGS、GET_VISA_BOOKING、GET_VISA_BOOKING_BY_APPLICATION_UUID、GET_VISA_UPDATES、GET_VISA_UPDATES_BY_BOOKING、GET_VISA_FOLLOWUP_QUESTIONS、ANSWER_VISA_FOLLOWUP、GET_VISA_NOTIFICATIONS、MARK_VISA_NOTIFICATION_READ、GET_VISA_TRANSACTIONS、GET_VISA_TRANSACTION_DETAIL

移民（tva-immigration-mcp）

GET_IMMIGRATION_INFO_BY_COUNTRY、LIST_MY_IMMIGRATION_BOOKINGS、GET_IMMIGRATION_BOOKING、GET_IMMIGRATION_UPDATES、GET_IMMIGRATION_UPDATES_BY_BOOKING、GET_IMMIGRATION_NOTIFICATIONS、MARK_IMMIGRATION_NOTIFICATION_READ、GET_IMMIGRATION_TRANSACTIONS、GET_IMMIGRATION_TRANSACTION_DETAIL

账户（tva-account-mcp）

REGISTER_USER、LOGIN_USER、SOCIAL_AUTH_LOGIN、FORGOT_PASSWORD、RESEND_OTP、VERIFY_OTP、LOGOUT_USER、GET_CURRENT_USER、GET_USER_PROFILE、EDIT_USER_PROFILE、CHANGE_PASSWORD、CHECK_DISCOUNT_PROMO、GET_USER_NOTIFICATIONS、CLOSE_ACCOUNT

被以下项目使用

MegaMind 的 NomadSage 旅行代理生成这些服务器（通过 stdio，每个域一个），以及其知识库搜索和 social-mcp 回复工具——请参阅该仓库中的 travel-agent/src/lib/tva-client.ts 和 travel-agent/src/lib/tva-session.ts。