southwest

@striderlabs/mcp-southwest

适用于 Southwest Airlines 的 MCP 服务 — 通过浏览器自动化搜索航班、管理预订、办理值机，并管理 Rapid Rewards 账户。

功能

• 搜索航班，获取所有票价等级的实时价格
• 比较票价：Wanna Get Away、Wanna Get Away+、Anytime、Business Select
• 预订航班，使用现金或 Rapid Rewards 积分支付
• 管理预订：更改、取消、查看详情
• 不收取改签费 — Southwest 永不收取改签费
• 在线值机（恰好在起飞前 24 小时开放）
• 获取登机牌，查看组别／位置（A／B／C）
• Early Bird Check-In — 在起飞前 36 小时自动办理值机
• Rapid Rewards — 查看积分余额、会员等级状态和 Companion Pass 进度

前置条件

• Node.js 18+
• Playwright 浏览器：npx playwright install chromium

安装

npm install -g @striderlabs/mcp-southwest
# or
npx @striderlabs/mcp-southwest

设置

环境变量

创建 .env 文件，或在环境中设置以下变量：

# Required for account-based tools (check-in, Rapid Rewards, points booking)
SW_USERNAME=your_rapid_rewards_number_or_email
SW_PASSWORD=your_password

# Optional
SW_HEADLESS=true   # Set to "false" to see the browser (useful for debugging)

Claude Desktop 配置

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "southwest": {
      "command": "npx",
      "args": ["@striderlabs/mcp-southwest"],
      "env": {
        "SW_USERNAME": "your_rapid_rewards_number",
        "SW_PASSWORD": "your_password"
      }
    }
  }
}

或者，如果是全局安装：

{
  "mcpServers": {
    "southwest": {
      "command": "mcp-southwest",
      "env": {
        "SW_USERNAME": "your_rapid_rewards_number",
        "SW_PASSWORD": "your_password"
      }
    }
  }
}

可用工具

search_flights

搜索可预订的 Southwest 航班。

{
  "originAirport": "DAL",
  "destinationAirport": "LAX",
  "departureDate": "2024-06-15",
  "passengers": 2,
  "tripType": "oneway",
  "fareType": "USD"
}

get_flight_details

获取指定航班的状态和详情。

{
  "flightNumber": "WN1234",
  "flightDate": "2024-06-15",
  "originAirport": "DAL",
  "destinationAirport": "LAX"
}

select_flight

从搜索结果中选择航班以继续预订。

{
  "flightIndex": 0,
  "fareType": "wanna-get-away"
}

get_fares

比较各票价等级的价格和权益。

{
  "originAirport": "HOU",
  "destinationAirport": "MCO",
  "departureDate": "2024-07-04",
  "fareType": "USD"
}

add_early_bird

为现有预订添加 Early Bird Check-In（每人／每航班约 $15–25）。

{
  "confirmationNumber": "ABC123",
  "firstName": "Jane",
  "lastName": "Smith"
}

checkout

填写乘客和付款信息以完成预订。

{
  "firstName": "Jane",
  "lastName": "Smith",
  "dateOfBirth": "01/15/1990",
  "gender": "F",
  "email": "[email protected]",
  "phone": "5551234567",
  "cardNumber": "4111111111111111",
  "cardExpiration": "12/26",
  "cardCvv": "123",
  "cardZip": "75201",
  "cardName": "Jane Smith",
  "addEarlyBird": false
}

get_reservation

通过确认编号查询预订。

{
  "confirmationNumber": "ABC123",
  "firstName": "Jane",
  "lastName": "Smith"
}

change_flight

修改现有预订（不收取改签费！）。

{
  "confirmationNumber": "ABC123",
  "firstName": "Jane",
  "lastName": "Smith",
  "newDepartureDate": "2024-06-20"
}

cancel_flight

取消预订。设置 confirm: true 以实际取消。

{
  "confirmationNumber": "ABC123",
  "firstName": "Jane",
  "lastName": "Smith",
  "confirm": true
}

check_in

在线办理值机（起飞前 24 小时开放）。

{
  "confirmationNumber": "ABC123",
  "firstName": "Jane",
  "lastName": "Smith"
}

get_boarding_pass

获取登机牌以及组别和位置编号。

{
  "confirmationNumber": "ABC123",
  "firstName": "Jane",
  "lastName": "Smith",
  "savePath": "~/boarding-pass.pdf"
}

get_rapid_rewards

查看 Rapid Rewards 积分、会员等级状态和 Companion Pass 进度。

{}

（使用 SW_USERNAME／SW_PASSWORD 环境变量）

book_with_points

搜索航班并使用 Rapid Rewards 积分预订。

{
  "originAirport": "DAL",
  "destinationAirport": "DEN",
  "departureDate": "2024-08-10",
  "passengers": 1
}

Southwest Airlines 票价等级

票价	可退款	积分倍率	登机
Wanna Get Away	旅行资金	基础积分的 6 倍	标准
Wanna Get Away+	可转让资金	基础积分的 8 倍	标准
Anytime	全额退款	基础积分的 10 倍	优先（A1–A15）
Business Select	全额退款	基础积分的 12 倍	保证 A1–A15

Southwest 登机系统

Southwest 采用开放选座 — 不分配座位。乘客按组登机：

• A 组（A1–A60）：Early Bird／Business Select／Anytime 优先登机
• B 组（B1–B60）：普通登机
• C 组（C1–C60）：最后登机

值机顺序决定登机位置。要获得最佳位置，请恰好在起飞前 24 小时办理值机。

会话持久化

登录会话会保存到 ~/.config/mcp-southwest/session.json，以免每次运行时都重新进行身份验证。

开发

git clone https://github.com/markswendsen-code/mcp-southwest
cd mcp-southwest
npm install
npx playwright install chromium
npm run build
npm start

如需启用热重载进行开发：

npm run dev

如需在自动化过程中查看浏览器（便于调试）：

SW_HEADLESS=false npm run dev

许可证

MIT © Strider Labs