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

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

> **v0.5.0 核心设计：每个使用者必须配置自己的飞猪 API Key 才能调用飞猪工具。**
> - MCP 包、SCF 代码、公开源码中**不含任何开发者 Key**；
> - 签名密钥只存在 SCF 环境变量（`FLYAI_SIGN_SECRET`），使用者完全不可见；
> - 调用飞猪时以**使用者的 Key** 作为鉴权，调用量计入使用者自己的 Key，与开发者配额完全隔离。

## ⚠️ 版本演进

- **v0.4.2**：源码内置 SCF 地址与令牌，任何人可盗刷 → 已废弃。
- **v0.4.3**：SCF 地址/令牌改为环境变量注入，但后端仍使用**开发者的共享 Key**，所有用户共享同一配额。
- **v0.5.0**：强制**用户自带 Key**。SCF 不再配置共享 Key，缺少用户 Key 的请求一律 401 拒绝。

## 环境变量

### 部署方（魔搭后台配置，使用者不可见/不可改）

| 变量 | 必填 | 说明 |
|---|---|---|
| `FLYAI_PROXY` | 是（飞猪工具） | 飞猪 SCF 代理地址，如 `https://xxx.ap-guangzhou.tencentscf.com` |
| `FLYAI_PROXY_TOKEN` | 是（飞猪工具） | 飞猪 SCF 代理令牌（与代理侧 `PROXY_TOKEN` 一致） |
| `GAODE_PROXY_TOKEN` | 按需 | 高德 SCF 代理令牌（美食/交通用） |

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

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

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

## 魔搭 hosted MCP 部署步骤

1. 发布本包到 PyPI（`0.5.0`）。
2. 在魔搭后台，将 MCP 的安装参数改为 `mcp-fliggy-travel==0.5.0`。
3. 在魔搭后台"环境变量配置"中填写部署方变量：`FLYAI_PROXY`、`FLYAI_PROXY_TOKEN`。
4. 使用者在魔搭上连接该 MCP 时，在环境变量中填写自己的 `FLYAI_API_KEY`。
5. 自测：不带 Key 调用 → 401/错误提示；带自己 Key 调用 → 正常返回。

## 本地直跑（调试）

```bash
FLYAI_PROXY=https://your-proxy-url \
FLYAI_PROXY_TOKEN=your-token \
FLYAI_API_KEY=sk-你的key \
uvx mcp-fliggy-travel==0.5.0
```

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

```json
{
  "mcpServers": {
    "fliggy-travel": {
      "command": "uvx",
      "args": ["--from", "mcp-fliggy-travel==0.5.0", "mcp-fliggy-travel"],
      "env": {
        "FLYAI_API_KEY": "sk-你的key",
        "FLYAI_PROXY": "https://your-proxy-url",
        "FLYAI_PROXY_TOKEN": "your-token"
      }
    }
  }
}
```

## 工具列表

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