Metadata-Version: 2.4
Name: mcp-domestic-flight
Version: 3.0.0
Summary: 国内航班实时查询MCP服务，基于飞猪旅行数据
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.9.0
Requires-Dist: pydantic>=2.0.0

# mcp-domestic-flight

国内航班实时查询 MCP 服务，基于飞猪旅行数据。

## 安装

```bash
pip install mcp-domestic-flight
```

## 使用

```bash
mcp-domestic-flight
```

## 工具

### search_flight

查询国内航班实时价格与时刻表，支持城市中文名输入，返回航班号、起降时间、价格及预订链接。数据来源：飞猪旅行。

参数：

- **origin**（必填）：出发城市，中文城市名，如：上海、北京、广州、成都
- **destination**（必填）：到达城市，中文城市名，如：北京、成都、深圳、三亚
- **depDate**（必填）：出发日期，格式 YYYY-MM-DD
- **seatClass**（可选）：舱位选择，economy(经济舱) / business(商务舱) / first(头等舱)，默认 economy
- **sortType**（可选）：排序方式，1(价格降序) / 2(推荐) / 3(价格升序) / 4(时长升序) / 6(出发早到晚) / 7(出发晚到早) / 8(直飞优先)，默认 2
- **maxPrice**（可选）：最高价格（元），如 500，0 表示不限
- **journeyType**（可选）：航班类型，1=仅直达、2=仅中转，不填则显示全部
- **transportNo**（可选）：指定航班号，如：CZ8881

## 变更日志

### v3.0.0 (2026-08-26)

- **破坏性变更**：所有对外 MCP 参数统一为 camelCase 命名，与飞猪官方 schema 对齐
  - `dep_date` → `depDate`
  - `seat_class` → `seatClass`
  - `sort_type` → `sortType`
  - `max_price` → `maxPrice`
  - `journey_type` → `journeyType`
  - `transport_no` → `transportNo`
- 使用 `Annotated` + `Field` 提供更清晰的参数描述
- MCP server 名称统一为 `domestic-flight-search`
