Metadata-Version: 2.4
Name: mcp-fliggy-travel
Version: 1.0.0
Summary: 飞猪旅行 MCP Server - 11个工具覆盖行程/机票/火车/酒店/景点/美食，用户自带API Key直连飞猪开放平台
Author: fliggy-travel
License: MIT
Keywords: mcp,fliggy,飞猪,travel,机票,酒店
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp>=2.0.0

# 飞猪旅行 MCP

飞猪旅行一站式 MCP Server，提供行程规划、机票、火车票、酒店、景点门票、美食、市内交通等 11 个旅行工具。

- 数据来源：飞猪开放平台（机票/火车/酒店/景点）+ 高德地图（美食/交通）
- 接入方式：用户自带 `FLYAI_API_KEY` 直连飞猪开放平台，签名协议自动完成，无需中转服务
- 安全：API Key 仅用于请求鉴权，不会出现在任何返回文本中

## 工具列表

| 工具 | 说明 |
|---|---|
| 🗺️ travel_plan | 行程规划：自然语言描述需求，智能推荐行程方案 |
| 🚄 search_train | 火车票查询：余票、价格、时刻表、预订链接 |
| ✈️ search_flight | 机票查询：实时票价、航班号、起降时间 |
| 🏨 search_hotel | 酒店搜索：按目的地、星级、价格、关键词筛选 |
| 🎫 search_poi | 景点门票：门票价格、购票链接 |
| 🍜 search_food | 美食推荐：周边餐厅、评分、人均、地址 |
| 🚇 search_transport | 市内交通：打车预估、公交地铁方案 |
| ⚡ search_fast | 极速搜索：飞猪通用搜索极速版 |
| 🏨 search_marriott_hotel | 万豪酒店搜索 |
| 📄 get_marriott_hotel_info | 万豪酒店详情 |
| 🎁 search_marriott_package | 万豪酒店套餐搜索 |

## 环境变量

| 变量 | 必填 | 说明 |
|---|---|---|
| FLYAI_API_KEY | 是 | 飞猪开放平台 API Key，前往飞猪开放平台申请 |
| FLYAI_SIGN_SECRET | 否 | 签名密钥，默认使用飞猪官方内置值 |
| FLYAI_BASE_URL | 否 | 飞猪开放平台地址，默认 https://flyai.open.fliggy.com/mcp |
| GAODE_PROXY | 否 | 高德代理地址（美食/交通用），默认内置 |
| PROXY_TOKEN | 否 | 高德代理令牌，默认内置 |

## 安装运行

安装：

```bash
pip install mcp-fliggy-travel
```

运行（先设置环境变量）：

```bash
export FLYAI_API_KEY=你的Key
mcp-fliggy-travel
```

## 示例

- 帮我规划三亚5天亲子游
- 查一下明天上海到北京的火车票
- 上海到三亚的机票多少钱
- 推荐杭州西湖附近的酒店
- 北京故宫门票多少钱
- 上海南京路附近有什么好吃的
- 浦东机场到外滩怎么走
- 三亚万豪酒店有哪些

## 数据来源

- 飞猪开放平台：https://flyai.open.fliggy.com
- 高德地图开放平台：https://lbs.amap.com

价格、余票、评分等信息实时变动，请以实际下单为准。
