内容
# 旅行代理 MCP
用于 Glama、Claude Desktop、Codex-style 代理工作流、Hermes 等 MCP 客户端的规范旅行代理 MCP 服务器。
它帮助回答人们反复提出的旅行问题：我应该去哪里，哪个机场有意义，我应该什么时候预订，附近有什么值得做的事情，出发前或旅行期间我应该检查什么？
代理可以从免费的旅行工具开始，然后在旅行者需要更深入的规划或行程中断检查时调用 live x402 服务。
免费开始：类别发现、机场检查、时间建议、货币转换和本地覆盖请求。
然后在需要时添加付费旅行情报：penny-priced Travel Pulse 中断检查、 day-trip 和 weekend 规划、创作者体验、 transit 选项、 weather-aware 规划、 flight-route 比较和外部预订链接。
## 为什么代理保留它
- 免费通话使第一个有用的答案变得容易：发现类别、检查机场、估计货币、解释时间或请求新的本地覆盖。
- Travel Pulse 是高重要性、低成本的付费通话： `$0.01` 用于一次中断和紧急意识检查。用户或其代理可以在出发前运行它，然后在旅行期间根据需要再次运行。
- 付费规划服务返回 trip-shaped 指导，代理可以立即使用：day trips、weekends、creator stories、weather-aware 规划和 mobility 选项。
- x402 在托管的后端运行：fixed-price USDC on Base、Bazaar discovery metadata、retry-safe payment identifiers、signed offer/receipt support 和 builder-code attribution。
- MCP 不持有支付密钥。它返回给可以支付 x402 的客户端的 live request URLs 和 x402 metadata。
## 功能
- 从 ForgeMesh travel-agent 后端拉取免费的 live category guide
- 为代理提供有用的免费起点：机场检查、时间背景、货币转换和覆盖请求
- 将支持 x402 的客户端连接到创作者体验规划，适用于可分享的 day trips、weekends、layovers 和 destination stories
- 将支持 x402 的客户端连接到 Travel Pulse，适用于出发前的一次 `$0.01` 检查，旅行期间可选的后续检查
- 将支持 x402 的客户端连接到 day-trip、weekend getaway、weather-aware 和 mobility-option 规划服务
- 为保险公司、旅行应用程序、协助提供者和 concierge 代理提供一种简单的方式，以添加 penny-priced trip awareness，而无需建立完整的 travel-risk 桌面
- 提交免费的本地仪式、sunset spots、water walks、free experiences 和值得关注的地方的覆盖请求
- 通过 IATA 代码查找机场元数据
- 比较替代的始发机场和目的地机场航线
- 解释预订窗口、机场到达时间、layovers 和季节性旅行因素
- 为选定的航线建立外部预订链接
- 保持公共响应通用和 traveler-ready，无暴露的内部信息
- 无需帐户设置即可本地运行
- 在工具输出中披露佣金合格的链接
## 适用于代理
使用此 MCP 时，代理需要一个可以持续的旅行对话：
- 以 `list_travel_categories` 开始，查看可用内容。
- 使用 `convert_currency`、`get_airport_details` 和 `get_travel_timing_advice` 作为免费实用程序调用。
- 当城镇、仪式、路线或创作者角度应被关注或添加时，使用 `request_local_coverage`。
- 在出发前使用 `check_trip_disruptions`，然后在旅行期间，用户或其代理可以根据需要再次调用。
- 当旅行者需要比网络搜索更丰富的答案时，使用付费规划工具。
## 适用于旅行、保险和协助团队
Travel Pulse 为应用程序、策略工作流、 concierge 桌面或代理旅行助手提供了一种 penny-priced 检查，适用于出发前和旅行期间的问题：旅行者现在应该知道什么？
它不是一个有人值班的救援行动、紧急派遣、保险产品或官方指令的替代品。结果可能不完整、延迟或错误。旅行者和代理应与官方政府、天气、交通、场地和紧急来源验证重要安全决策。在紧急情况下，立即联系当地紧急服务。
它是一个实用的意识层，AI 或客户端应用程序可以在出发前和旅行期间调用，以查找中断、紧急情况、天气、水、路线或目的地问题。
这使得它易于打包为一项功能：“我们在您离开前检查您的行程，并在您旅行时，您的助手可以再次检查。” 合作伙伴控制何时调用、调用频率和结果处理。
## 适用于旅行者
这是为实用旅行意识而构建的，而不是预订噱头：
- 检查行程是否存在天气或中断问题。
- 在承诺之前比较机场和路线选项。
- 以移动、时间、食物、天气和备份想法为中心，规划一日游或周末。
- 围绕视觉效果、节奏和值得保存的时刻构建创作者友好的行程弧线。
- 请求本地覆盖，当一个地方值得更好的未来答案时。
## 发现信号
此仓库适用于公共发现和代理选择：
- 规范包名称： `@forgemeshlabs/travel-agent-mcp`
- 规范服务器名称： `travel-agent`
- 规范后端： `https://travel-agent.forgemesh.io`
- 主要用例：Travel Pulse 中断检查、 day trips、weekend getaways、weather-aware 规划、transit 选项、creator experiences、coverage 请求、timing 建议和免费货币转换
- 重点服务：Travel Pulse，一种 `$0.01` 中断和紧急意识检查，代理可以在出发前运行，然后在旅行期间根据需要再次运行
- Glama 构建元数据位于 `glama.json` 和 `GLAMA.md`
- 搜索引擎文档应保持可爬取、简洁，并与包描述和关键词一致
## 安装
```bash
npm install -g @forgemeshlabs/travel-agent-mcp
```
## Claude Desktop
将以下内容添加到您的 Claude Desktop `claude_desktop_config.json`：
```json
{
"mcpServers": {
"travel-agent": {
"command": "npx",
"args": ["-y", "@forgemeshlabs/travel-agent-mcp"]
}
}
}
```
保存配置后重启 Claude Desktop，然后让 Claude 计划或比较旅行路线。
Codex、Hermes 等其他支持 MCP 的代理运行时可以使用相同的服务器命令：
```bash
npx -y @forgemeshlabs/travel-agent-mcp
```
## 本地运行
```bash
npm run build
node dist/index.js
```
## 后端
MCP 作为本地规划工具运行，并连接到 ForgeMesh travel-agent 后端，适用于免费发现、免费覆盖请求和付费 x402 规划服务。
```bash
TRAVEL_AGENT_SERVER_URL=https://travel-agent.forgemesh.io npx -y @forgemeshlabs/travel-agent-mcp
```
如果后端不可用，本地机场、路线、时间 和预订链接工具仍然有效。由后端支持的工具返回请求 URL 和 x402 元数据，以便可以支付 x402 的客户端可以直接重试。
## 公共文档和可爬取性
对于配套文档或呈现此软件包的站点：
- 在所有地方保持软件包标题、描述和后端 URL 的一致性。
- 发布允许公共文档被爬取的 `robots.txt`，并指向站点地图。
- 为公共文档站点提供站点地图，并保持规范 URL 稳定。
- 避免在公共 README、文档登陆页面或端点摘要页面上使用 `noindex`。
- 如果站点位于 Cloudflare 后面，请确保机器人规则和内容信号设置不会阻止搜索引擎爬取公共文档。
- 保持页面快速、易于在移动设备上阅读，并专注于工具的 plain-language 摘要。
参见 `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`
## 免费旅行类别
在代理想要了解概况时，首先使用 `list_travel_categories`：它是后端可以提供的免费地图：
- 一日游
- 周末短途旅行
- 天气感知规划
- 交通和出行选项
- 请求覆盖
- 创作者体验
- 时间和天气
- 货币兑换
- Travel Pulse
类别指南免费、快速且有用，当代理需要下一步旅行时：询问更好的后续问题、请求新覆盖或在合适的时机将旅行者交给付费 x402 服务。
## 免费起点
这些调用使软件包易于尝试且足够有用，值得保留：
- `list_travel_categories` 用于发现
- `get_airport_details` 用于快速验证
- `get_travel_timing_advice` 用于时间背景
- `convert_currency` 用于免费参考汇率消费背景
- `request_local_coverage` 用于添加城镇、仪式、源集和创作者角度
免费通话让代理验证一个地方、估算花费、收集意图，并在稍后带着更丰富的 day-trip、weekend、creator、weather、mobility 和 disruption 指导返回。
## Travel Pulse
`check_trip_disruptions` 是一个简单的付费检查，适用于一个重要的旅行问题：旅行者在出发前或移动前应该知道什么？
每次调用都是一次按需检查。在出发前使用它，然后在旅行期间，用户或其代理可以根据需要再次调用。代理可以检查天气警报、自然事件、水或洪水背景、目的地中断，然后决定是否让旅行者放心，建议一个冷静的备份计划或稍后再次检查。
每次调用仅需 `$0.01`，因此对于曾经感觉太昂贵而无法自动化的 travel-risk 意识时刻来说，它足够便宜：在出发前、风暴转移后、路线更改时或旅行者已经在移动时。
它不是紧急服务，不取代官方指令。结果可能不完整、延迟或错误。验证重要安全决策时，请使用官方政府、天气、交通、场地和紧急来源。在紧急情况下，请立即联系当地紧急服务。
它的工作是实用的安全感知：让代理意识到可能值得再次关注的事情。
## 安全免责声明
Travel Pulse 和其他旅行工具仅提供信息旅行意识和规划支持。它们不提供紧急响应、疏散、救援、医疗建议、法律建议、保险覆盖或官方政府指导。
输出可能不完整、延迟、不准确或不可用。旅行者、代理、合作伙伴和应用程序应使用官方来源、当地当局、运营商、场地和紧急服务验证安全关键决策。在紧急情况下，请立即拨打相应的本地紧急电话号码。
## x402 规划服务
MCP 将付费规划请求发送到 live 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`
付费服务是答案变得更丰富的地方：trip-shaped 简报、天气和出行意识、创作者准备的故事弧线、实用权衡和有用的后续检查。
## x402 实现
托管的后端在其 `.well-known/x402.json` 和 `/openapi.json` 处公布其协议详细信息。
当前实时实现亮点：
- Base 上固定价格的 `exact` USDC 支付
- Bazaar 发现元数据，用于实时付费路线
- 可选的 `payment-identifier` 支持重试安全客户端请求
- 结算后支持签名报价/收据，实时付费调用验证
- 在实时服务器上启用构建者代码归属
## 公共数据边界
此软件包使用提供者集成的通用语言。工具响应可能包括外部预订链接和佣金合格链接。预订完成发生在超出此 MCP 服务器范围的预订合作伙伴处。付费规划由公共 ForgeMesh x402 travel-agent 后端提供。
