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 拒绝。

环境变量

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

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

未填写 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 调用 → 正常返回。

本地直跑（调试）

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

安装运行（MCP 客户端）

{
  "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"
      }
    }
  }
}

工具列表