seats.aero MCP server

seats.aero MCP 服务

重要

此 MCP 服务已不再维护，也不会再收到更新。 seats.aero 现已提供 官方 MCP 服务；对于新的和现有的集成，请使用官方服务。

与 seats.aero 无关联

一个精简的 TypeScript MCP 服务，用于通过 seats.aero 合作伙伴 API 搜索奖励机票可用情况。

你需要 seats.aero Partner API 密钥。符合条件的 seats.aero Pro 用户可以在 seats.aero 设置中生成密钥；使用仍须遵守 seats.aero 条款和 API 限制。

端点访问权限

并非每位 Partner API 用户都能使用所有端点：

• live_search 不能使用 seats.aero Pro API 密钥。使用该端点需要与 seats.aero 达成商业协议。
• 商业用户目前不能使用 refresh_cached_data；API 文档建议商业用户改用 live_search。

服务无法在本地确定 API 密钥的类型，因此会在 MCP 指令、工具描述和工具元数据中说明这些限制。

设置

需要 Node.js 20 或更高版本。

pnpm install
pnpm build
pnpm start

在 MCP 客户端配置中设置 SEATS_API_KEY：

{
  "mcpServers": {
    "seats": {
      "command": "node",
      "args": ["/absolute/path/to/seats-mcp/build/index.js"],
      "env": {
        "SEATS_API_KEY": "YOUR_SEATS_AERO_API_KEY"
      }
    }
  }
}

工具

工具	seats.aero 端点	访问权限	用途
get_flights	缓存搜索	Partner API	跨机场、日期、客舱、承运航空公司和里程计划搜索缓存的可用情况。
get_bulk_avail	批量可用情况	Partner API	从一个里程计划中检索多个缓存的可用情况对象。
get_routes	获取航线	Partner API	列出一个里程计划所跟踪的航线。
get_destinations	获取目的地	Partner API	查找从一个机场直飞可达的机场，以及每个客舱的最低原始价格。
get_trips	获取行程	Partner API	检索 Availability 对象的航班级详细信息。
refresh_cached_data	刷新缓存数据	Pro 用户；非商业用户	为缓存的 Availability 对象排队或轮询刷新任务。
live_search	实时搜索	仅限商业协议；Pro 用户不可用	为一个里程计划实时搜索指定航线和日期。

缓存搜索接受逗号分隔的机场列表（SFO,LAX）、客舱列表（economy,business）、承运航空公司列表（DL,AA）和来源列表（aeroplan,united）。日期格式为 YYYY-MM-DD。

实时搜索通常需要 5-15 秒。航空公司不可用时，搜索可能失败，因此调用方应限制重试次数并采用指数退避。缓存的可用情况足够时，优先使用 get_flights。

此服务涵盖当前 seats.aero API 参考中所有七个启用的 Partner-Authorization 端点。OAuth 同意、令牌和用户信息端点不作为工具提供，因为它们属于应用授权流程，而非奖励机票可用情况操作；此服务使用 SEATS_API_KEY 进行身份验证。

开发

pnpm test

测试会构建此服务，并通过模拟的 seats.aero API 测试请求构造。

发布

发布遵循语义化版本，并通过 Release Please 在 GitHub 上管理：

• fix: 提交会生成补丁版本。
• feat: 提交会生成次要版本。
• 类型后带有 ! 的提交，或带有 BREAKING CHANGE: 页脚的提交，会生成 主要版本。
• docs:、test:、chore: 和其他不面向用户的提交本身不会触发 发布。

值得发布的提交合并到 main 后，GitHub Actions 会创建或更新一个发布 PR，其中包含下一个版本号和变更日志。合并该 PR 后，会创建相应的 vX.Y.Z Git 标签和已发布的 GitHub Release。完整工作流请参阅 CONTRIBUTING.md。