Metadata-Version: 2.4
Name: mcp-fliggy-travel
Version: 0.5.1
Summary: 飞猪旅行一站式 MCP Server - 11个工具覆盖行程/机票/火车/酒店/景点/美食，用户自带 Key 走 SCF 代理
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-fliggy-travel v0.5.1

飞猪旅行一站式 MCP Server：11 个工具（行程规划、机票、火车票、酒店、景点门票、美食、市内交通等）。
数据源：飞猪旅行 SCF 代理（9 个工具）+ 高德地图 SCF 代理（美食/交通）。

> **v0.5.1 核心设计：每个使用者必须配置自己的飞猪 API Key 才能调用飞猪工具。**
> - 包内置 SCF 代理地址与令牌（对使用者透明，无需关心）；
> - 使用者只需填写自己的 `FLYAI_API_KEY` 即可使用全部飞猪工具；
> - 调用飞猪时以**使用者的 Key** 作为鉴权，调用量计入使用者自己的 Key。

## 环境变量

### 使用者（魔搭 MCP 连接时的环境变量，必须填写）

| 变量 | 必填 | 说明 |
|---|---|---|
| `FLYAI_API_KEY` | **是** | **你自己的飞猪开放平台 API Key**。前往飞猪开放平台（open.fliggy.com）申请；填入后所有飞猪调用以此 Key 计费 |

> 未填写 `FLYAI_API_KEY` 时，飞猪相关工具返回明确错误提示：去飞猪开放平台申请 Key。

### 可选覆盖（一般无需设置）

| 变量 | 说明 |
|---|---|
| `FLYAI_PROXY` | 自定义飞猪 SCF 代理地址（覆盖内置默认值） |
| `FLYAI_PROXY_TOKEN` | 自定义飞猪 SCF 代理令牌（覆盖内置默认值） |
| `GAODE_PROXY_TOKEN` | 高德 SCF 代理令牌（美食/交通用） |

## 安装运行（MCP 客户端）

```json
{
  "mcpServers": {
    "fliggy-travel": {
      "command": "uvx",
      "args": ["--from", "mcp-fliggy-travel==0.5.1", "mcp-fliggy-travel"],
      "env": {
        "FLYAI_API_KEY": "sk-你的key"
      }
    }
  }
}
```

## 本地直跑（调试）

```bash
FLYAI_API_KEY=sk-你的key \
uvx mcp-fliggy-travel==0.5.1
```

## 工具列表

| 工具 | 说明 |
|---|---|
| 🗺️ 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 | 万豪酒店套餐搜索 |
