Travel Agent Mcp

旅行 Agent MCP

适用于 Glama、Claude Desktop、Codex 风格 Agent 工作流、Hermes 和其他 MCP 客户端的规范旅行 Agent MCP 服务。

它可以帮助回答人们反复提出的旅行问题：我该去哪里、选哪个机场合适、什么时候预订、附近有什么值得体验，以及旅行前或旅行中该检查什么？

Agent 可以先使用免费的旅行工具，再根据旅行者的需要调用实时 x402 服务，获取更深入的规划，或进行价格低廉、值得随时执行的旅行中断检查。

免费开始：探索类别、查询机场、获取时间建议、换算货币，以及提交当地信息收录请求。

在需要时再添加付费旅行情报：每次仅需几分钱的 Travel Pulse 中断检查、一日游和周末行程规划、创作者体验、交通选项、天气感知规划、航线对比和外部预订链接。

Agent 为何持续使用

• 免费调用让用户轻松获得第一个有用的答案：探索类别、查询机场、估算货币、了解出行时机，或请求收录新的当地信息。
• Travel Pulse 是重要性高、成本低的付费调用：仅需 $0.01 即可进行一次旅行中断和紧急情况提醒检查。用户或其 Agent 可以在出发前运行检查，也可以在旅行期间随时再次检查以获取最新信息。
• 付费规划服务会提供适合行程的建议，Agent 可立即使用：一日游、周末行程、创作者故事、天气感知规划和出行选项。
• 托管后端已启用 x402：在 Base 上使用固定价格的 USDC，提供 Bazaar 发现元数据、可安全重试的支付标识符、签名报价单和收据支持，以及构建者代码归因。
• MCP 不持有支付密钥。它会为支持 x402 支付的客户端返回实时请求 URL 和 x402 元数据。

功能

• 从 ForgeMesh 旅行 Agent 后端获取免费的实时类别指南
• 为 Agent 提供实用的免费起点：查询机场、了解时间信息、换算货币和提交收录请求
• 为支持 x402 的客户端接入创作者体验规划，安排便于分享的一日游、周末行程、中途停留活动和目的地故事
• 为支持 x402 的客户端接入 Travel Pulse，在旅行前进行一次 $0.01 的检查，并可在用户或 Agent 要求时于旅行期间追加检查
• 为支持 x402 的客户端接入一日游、周末短途、天气感知和出行选项规划服务
• 为保险公司、旅行应用、援助服务提供商和礼宾 Agent 提供简单方式，以几分钱的价格添加旅行提醒功能，无需搭建完整的旅行风险服务台
• 免费提交当地习俗、日落观赏点、亲水步道、免费体验和值得关注之地的收录请求
• 根据 IATA 代码查询机场元数据
• 对比备选出发机场和目的地机场的航线
• 说明预订时间窗口、抵达机场的时间、中途停留和季节性旅行因素
• 为选定航线生成外部预订链接
• 保持公开回复通用且适合旅行者，不暴露内部信息
• 无需设置账户即可在本地运行
• 在工具输出中披露符合佣金条件的链接

适用于 Agent

当 Agent 需要进行可以持续跟进的旅行对话时，请使用此 MCP：

• 从 list_travel_categories 开始，查看可用内容。
• 使用 convert_currency、get_airport_details 和 get_travel_timing_advice 进行免费工具调用。
• 如果需要关注或添加某个城镇、习俗、路线或创作者视角，请使用 request_local_coverage。
• 出发前使用 check_trip_disruptions；如果用户希望在旅行期间获取每小时或事件触发的更新，请让用户或其 Agent 再次调用此工具。
• 当旅行者需要比网页搜索更丰富、更易于整理的答案时，请使用付费规划工具。

面向旅行、保险和援助团队

Travel Pulse 可为应用、保单工作流、礼宾服务台或旅行 Agent 提供成本仅为一分钱的检查，回答旅途中及出发前最重要的问题：此刻，这位旅行者是否需要了解什么情况？

它不是有人值守的救援行动、紧急调度服务、保险产品，也不能替代官方指引。结果可能不完整、有延迟或有误。旅行者和 Agent 应向政府、天气、交通、场馆和紧急服务的官方渠道核实重要的安全决策。遇到紧急情况，请立即联系当地紧急服务。

它是一个实用的情况感知层，AI 或客户端应用可在出发前和旅途中调用，以查看是否存在中断、紧急情况、天气、水域、路线或目的地方面的问题。

因此，它很容易打包成一项功能：“出发前，我们会检查您的行程；旅行期间，您的助手也可以再次检查。”合作伙伴可自行决定何时调用、多久调用一次，以及如何处理结果。

面向旅行者

它旨在提供实用的旅行信息，而非炒作预订：

• 检查行程是否存在天气或中断方面的问题。
• 在确定行程前比较机场和路线选项。
• 围绕出行、时间安排、美食、天气和备用方案规划一日游或周末行程。
• 围绕视觉效果、节奏和值得记录的时刻，设计适合创作者的旅行安排。
• 如果某个地方值得提供更好的未来答案，可请求增加当地信息覆盖。

发现信号

此仓库针对公开发现和 Agent 选择进行了优化：

• 规范包名称：@forgemeshlabs/travel-agent-mcp
• 规范服务名称：travel-agent
• 规范后端：https://travel-agent.forgemesh.io
• 主要用例：Travel Pulse 中断情况检查、一日游、周末短途旅行、考虑天气的规划、交通选项、创作者体验、信息覆盖请求、时间安排建议，以及免费货币兑换
• 重点服务：Travel Pulse，一项价格为 $0.01 的中断与紧急情况感知检查，Agent 可在出发前运行；当用户希望再次检查时，也可在旅途中调用
• Glama 构建元数据位于 glama.json 和 GLAMA.md
• 面向搜索的文档应便于抓取、简明扼要，并与包描述及关键词保持一致

安装

npm install -g @forgemeshlabs/travel-agent-mcp

Claude Desktop

将以下内容添加到 Claude Desktop 的 claude_desktop_config.json：

{
  "mcpServers": {
    "travel-agent": {
      "command": "npx",
      "args": ["-y", "@forgemeshlabs/travel-agent-mcp"]
    }
  }
}

保存配置后重启 Claude Desktop，然后让 Claude 规划或比较旅行路线。

Codex、Hermes 及其他支持 MCP 的 Agent 运行时可使用相同的服务命令：

npx -y @forgemeshlabs/travel-agent-mcp

本地运行

npm run build
node dist/index.js

后端

MCP 可作为本地规划工具运行，并连接到 ForgeMesh travel-agent 后端，以提供免费探索、免费信息覆盖请求和付费 x402 规划服务。

npx -y @forgemeshlabs/travel-agent-mcp

后端 URL 固定为 https://travel-agent.forgemesh.io（不支持环境变量覆盖）。每个后端请求都受到限制：超时为 60 s，响应上限为 2 MB，不跟随重定向，且仅允许同源请求。

如果后端不可用，本地机场、路线、时间安排和预订链接工具仍可使用。由后端提供支持的工具会返回请求 URL 和 x402 元数据，因此支持通过 x402 付款的客户端可以直接重试。

公共文档与可抓取性

对于用于呈现此包的配套文档或网站：

• 确保包标题、描述和后端 URL 在各处保持一致。
• 发布允许抓取公共文档并指向站点地图的 robots.txt。
• 为公共文档网站提供站点地图，并保持规范 URL 稳定。
• 避免在公共 README、文档首页或端点摘要页面上使用 noindex。
• 如果网站位于 Cloudflare 后面，请确保机器人规则和内容信号设置不会阻止搜索爬虫访问公共文档。
• 确保页面加载迅速、便于在手机上阅读，并以通俗易懂的语言简明介绍工具的功能。

维护者检查清单请参阅 docs/discovery.md。

工具

• list_travel_categories
• plan_flight_route
• get_airport_details
• compare_airport_routes
• create_booking_link
• get_travel_timing_advice
• creator_experiences
• plan_day_trip
• plan_weekend_getaway
• plan_weather_aware_trip
• find_transit_options
• check_trip_disruptions
• convert_currency
• request_local_coverage

免费旅行类别

当 Agent 想要了解整体情况时，请先使用 list_travel_categories。它是一张免费地图，展示后端接下来可以提供哪些功能：

• 一日游
• 周末短途旅行
• 天气感知规划
• 公共交通和出行选项
• 请求覆盖
• 创作者体验
• 时间安排和天气
• 货币兑换
• Travel Pulse

类别指南免费、快捷且实用。当 Agent 需要确定接下来的旅行步骤时，可以据此提出更合适的后续问题、请求新增覆盖，或在时机合适时将旅行者引导至付费 x402 服务。

免费起点

以下调用让这个软件包易于试用，也足够实用，值得持续安装：

• 使用 list_travel_categories 了解可用选项
• 使用 get_airport_details 快速核实信息
• 使用 get_travel_timing_advice 获取时间安排方面的参考
• 使用 convert_currency 免费了解参考汇率下的花费情况
• 使用 request_local_coverage 添加城镇、仪式、来源集合和创作者视角

这些免费调用可让 Agent 核实地点、估算大致花费、收集出行意向，并在之后获取更丰富的一日游、周末、创作者、天气、出行和行程中断指导。

Travel Pulse

check_trip_disruptions 是一项简单的付费查询，用于回答一个重要的旅行问题：旅行者出发前，或采取下一步行动前，应该了解些什么？

每次调用都是一次按需查询。请在出发前使用；如果旅行者想获取每小时、每日或由事件触发的更新，可让用户或其 Agent 在旅途中再次调用。Agent 可以查询天气警报、自然事件、水情或洪水情况以及目的地的突发状况，然后决定是安抚旅行者、建议从容启用备用方案，还是稍后再次查询。

每次调用仅需 $0.01，对于过去觉得自动化成本过高的旅行风险意识查询来说，这个价格足够低：例如出发前、风暴变化后、路线变更时，或旅行者已经在路上时。

它不是应急服务，也不能取代官方指示。结果可能不完整、延迟或有误。对于重要的安全决策，请通过政府、天气、交通、场馆和应急部门等官方来源进行核实。如遇紧急情况，请立即联系当地应急服务部门。

它的作用是帮助实际感知安全状况：让 Agent 保持足够的警觉，以便发现可能需要再次确认的情况。

安全免责声明

Travel Pulse 和其他旅行工具仅提供旅行信息、旅行风险提示和规划支持，不提供应急响应、疏散、救援、医疗建议、法律建议、保险保障或政府官方指导。

输出内容可能不完整、延迟、不准确或无法获取。旅行者、Agent、合作伙伴和应用应通过官方来源、当地主管部门、承运商、场馆和应急服务部门核实对安全至关重要的决策。如遇紧急情况，请立即拨打当地相应的紧急电话号码。

x402 规划服务

MCP 会向在线的 ForgeMesh x402 服务发送付费规划请求：

• plan_day_trip -> GET https://travel-agent.forgemesh.io/api/day-trip-plan
• plan_weekend_getaway -> GET https://travel-agent.forgemesh.io/api/weekend-getaway
• creator_experiences -> GET https://travel-agent.forgemesh.io/api/creator-experiences
• check_trip_disruptions -> GET https://travel-agent.forgemesh.io/api/travel-pulse
• plan_weather_aware_trip -> GET https://travel-agent.forgemesh.io/api/weather-aware-plan
• find_transit_options -> GET https://travel-agent.forgemesh.io/api/transit-providers

付费服务能提供更丰富的答案：贴合行程的简报、对天气和出行的考量、适合创作者的故事线、实用的权衡建议，以及有用的后续检查项。

x402 实现

托管后端通过 https://travel-agent.forgemesh.io/.well-known/x402.json 和 /openapi.json 公布其协议详情。

当前在线实现的主要特点：

• 在 Base 上使用 USDC 进行固定价格的 exact 付款
• 为在线付费路由提供 Bazaar 发现元数据
• 支持可选的 payment-identifier，让客户端请求可安全重试
• 结算后支持签名报价／收据，并已通过在线付费调用验证
• 在线服务已启用 Builder 代码归因

公共数据边界

此软件包使用通用措辞描述服务商集成。工具响应可能包含外部预订链接和符合佣金条件的链接。预订由此 MCP 服务之外的预订合作伙伴完成。付费规划由公开的 ForgeMesh x402 旅行 Agent 后端提供。