Flytoday

flytoday-mcp：面向 AI Agent 的 Flytoday MCP 服务

让你的 AI Agent 在伊朗及海外通过 Flytoday（فلای‌تودی）规划行程。
一个面向 Flytoday（伊朗在线旅行社）的非官方只读 MCP 服务：
通过 Claude、Cursor 或 Copilot 查询最便宜的国内和国际机票、火车票和巴士票、票价规则和行李信息、价格准确的酒店和别墅，以及 CIP 贵宾休息室、eSIM 和签证。

面向 AI Agent · 为什么选择它 · 功能 · 快速开始 · 工具 · 须知 · 常见问题 · 配置 · فارسی · 开发

面向 AI Agent

• **内容：**面向 Flytoday（فلای‌تودی，flytoday.ir）这一伊朗旅游网站的非官方只读 MCP 服务（模型上下文协议）：提供伊朗国内及国际航班、伊朗境内及海外酒店、别墅和公寓、火车、巴士、CIP 贵宾休息室、eSIM、签证和活动。支持使用波斯语和英语查询；价格以托曼计。
• 安装：uvx flytoday-mcp 或 claude mcp add flytoday -- uvx flytoday-mcp。传输方式：stdio。需要 Python 3.10+ 和 uv。
• **身份验证：**无需身份验证、API 密钥或账户。可选设置 FLYTODAY_MCP_PROXY（HTTP 代理，或以逗号分隔的代理列表），仅在你的网络无法访问 flytoday.ir 或你的 IP 被限制速率时使用。系统代理设置不会生效。
• **访问权限：**只读。不提供登录、锁定座位、预订或付款，因此调用任何工具前都无需确认。所有工具均标注为 readOnlyHint: true。
• **工具：**共 22 个，名称均以 ft_ 为前缀。先使用查找工具（ft_find_airport、ft_find_hotel_place、ft_find_station、ft_find_bus_city）获取 ID。航班：ft_flight_calendar → ft_search_flights → ft_flight_details。酒店：ft_search_hotels → ft_hotel。别墅：ft_search_stays → ft_stay。
• **单位：**名称为 *_toman 的字段中，价格以托曼计（签证和部分活动的价格以外币计，参见 price_currency）；日期采用公历格式 YYYY-MM-DD，不接受过去的日期。search_id 和 fare_source_code 约 15 分钟后过期。
• **适用场景：**比较 Flytoday 上的航班、酒店、别墅、火车或巴士，或查询 CIP 贵宾休息室、eSIM、签证或活动的价格。
• **不适用场景：**你需要预订或付款时（用户需在 flytoday.ir 上自行操作）。搜索会按 IP 限制速率，因此优先使用日历和分页，而不是反复搜索。
• 机器可读信息：server.json；伊朗 MCP 服务目录：iran-mcp（TOOLS.md、servers.json、llms.txt）。

为什么要用

Flytoday（flytoday.ir，فلای‌تودی）提供伊朗国内及国际航班、酒店、别墅、火车、巴士、CIP 贵宾休息室、eSIM 和签证。要比较“哪天出行、乘飞机还是火车或巴士、住哪家酒店”，仍然需要加载许多页面。 使用 flytoday-mcp 的 Agent 一次就能完成：

**你：**10 月 20 日左右从德黑兰到马什哈德，最便宜的出行方式是什么？

**Agent：**调用 ft_flight_calendar(origin="THR", destination="MHD", date="2026-10-21", window="week")、 ft_train_calendar(origin="1", destination="191")

交通方式	最便宜的日期	价格（托曼）
航班	2026-10-20，航空公司 IRZ	11,056,700
火车	2026-10-20（以及当周大多数日期）	760,000

火车便宜得多；要我用 ft_search_trains 列出当天的列车吗？

_{真实工具输出，日期为 2026-10-07；价格和座位情况随时可能变化。价格以托曼计。}

功能

• **航班：**国内和国际航班、单程或往返、团体价格、航空公司、直飞、包机／系统航班和时间筛选
• **最低价日期：**航班（±15 天）、火车（约 16 天）和大巴（约 6 周）
• **票价详情：**退改规则、行李额度、国际入境须知
• **酒店：**伊朗境内及海外酒店的价格搜索、含取消条款的房型和餐食方案、住客评价
• **别墅和公寓：**伊朗境内的别墅和公寓，显示每晚及总价、按日期显示的日历（含不可订日期）
• **火车和大巴：**席别、剩余座位、停靠站、设施、VIP 和卧铺大巴
• **其他：**IKA 和 MHD 的 CIP 贵宾休息室、各国 eSIM 流量套餐、签证价格和所需材料、旅游团和门票
• **设计为只读：**无需登录，不保留座位、不预订、不付款

示例提示词：

• “下个月德黑兰飞往伊斯坦布尔的最低价日期是哪天？该票价的退票规则是什么？”
• “马什哈德从 21 日起住 2 晚的酒店，按价格从低到高排列，并提供免费取消。”
• “下周末在拉姆萨尔找一栋适合 4 人入住、每晚低于 500 万托曼的别墅。”
• “本周从德黑兰到马什哈德最便宜的火车是哪班？沿途停靠哪些站？”
• “土耳其 eSIM 多少钱？申请签证需要哪些材料？”
• ارزان‌ترین اتوبوس VIP تهران به اصفهان دوشنبه بعد؟
• ارزان‌ترین روز برای پرواز تهران به مشهد در هفته آینده کدام است؟
• قوانین استرداد و بار مجاز این بلیط خارجی چیست؟
• یک ویلا در رامسر برای ۴ نفر آخر هفته زیر ۵ میلیون تومان پیدا کن.

快速开始

你需要安装 uv。无需 API 密钥或账户。

claude mcp add flytoday -- uvx flytoday-mcp

claude mcp add flytoday -e FLYTODAY_MCP_PROXY=http://127.0.0.1:8080 -- uvx flytoday-mcp

{
  "mcpServers": {
    "flytoday": { "command": "uvx", "args": ["flytoday-mcp"] }
  }
}

{
  "servers": {
    "flytoday": { "type": "stdio", "command": "uvx", "args": ["flytoday-mcp"] }
  }
}

codex mcp add flytoday -- uvx flytoday-mcp

[mcp_servers.flytoday]
command = "uvx"
args = ["flytoday-mcp"]

{
  "mcpServers": {
    "flytoday": { "command": "uvx", "args": ["flytoday-mcp"] }
  }
}

每个类别都有自己的 ID，取自对应的查询工具：航班使用 IATA 代码（THR、MHD、IST），酒店使用 city_id / region_code，住宿使用 region_code，火车站使用车站代码（德黑兰为 1，马什哈德为 191），巴士城市使用 4 位数 ID（德黑兰为 0001，伊斯法罕为 0002）。

所有 22 个工具均标注为 readOnlyHint: true，并返回紧凑的结构化 JSON，不会让 Agent 的上下文塞满内容。

工作原理

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  flytoday-mcp  (runs on your machine)
      │
      │  HTTPS (optional proxy)
      ▼
  www.flytoday.ir/api/gateway  ──▶  api.flytoday.ir, placesearch.flytoday.ir

flytoday-mcp 在本地运行，并调用 flytoday.ir 网站使用的同一个公共网关。中间没有托管服务，也不需要 API 密钥，你的信息也不会发送到其他地方。请求通过模拟 Chrome 的 HTTP 客户端发出，同时最多处理两个请求，并在请求之间短暂随机暂停；失败的调用（超时、5xx、429）最多重试两次。静态查询列表（CIP 机场、eSIM 国家、签证国家）会缓存 6 小时。

重要须知

• 所有工具中的价格均以 Toman 为单位，字段名为 *_toman（API 返回 Rial；数值会除以 10）。 航班的 price_toman 为每位成人的价格，total_toman 为全体同行者的总价；酒店的 price_toman 为整个住宿期间的价格（另有 per_night_toman）；住宿的价格字段为 price_per_night_toman 和 total_toman；火车票按成人计价；巴士票按座位计价。 签证和部分活动的价格以外币表示（price_currency）。
• 日期的输入和输出均采用公历 YYYY-MM-DD 格式；不接受过去的日期。时间均为当地时间。
• 航班提供 airline（英文名称）和 airline_fa（波斯语名称，API 有提供时）。
• 酒店和住宿（搜索结果行、ft_hotel、ft_stay）包含 image，即封面照片，其路径根据网站的格式构建为 <cdn>/<id>/main.jpg（API 没有图片字段）。
• Flytoday 会按 IP 限制搜索频率：航班、火车和巴士搜索约 15 次；酒店搜索在 10 分钟内约 12 次后会要求输入验证码（封锁时间为一小时或更久）。请使用日历和分页（search_id），而不是重新搜索；工具不会循环执行搜索。
• ID 会过期：search_id 和 fare_source_code 的有效期约为 15 分钟。
• 售票时间窗口：火车票约提前 16 天开售。结果为空通常只是表示“尚未开售”。
• 铁路公司的链接不可用时，Flytoday 会返回 HTTP 599；ft_search_trains 会重试三次，然后说明情况。
• **不支持的功能：**预订、锁定座位、付款、退款或登录；不支持旅游团或套餐搜索，也不提供巴士座位图。
• **安全性：**只读。唯一的 POST 请求用于搜索和查询价格，这些是网站在预订前自行发起的请求。 同时最多发起两个请求，且任何工具都不会循环重复搜索。
• **代理：**如果你的网络无法访问 flytoday.ir，请设置 FLYTODAY_MCP_PROXY（参见配置）。

常见问题

npx @modelcontextprotocol/inspector uvx flytoday-mcp

配置

波斯语：Flytoday MCP 服务

claude mcp add flytoday -- uvx flytoday-mcp

开发

git clone https://github.com/sepehr071/flytoday-mcp && cd flytoday-mcp
uv sync
uv run python -m pytest  # offline, against recorded responses
uv run python -m pytest -m live  # real API, one search per tool (set FLYTODAY_MCP_PROXY if needed)
uv run ruff check .

工具位于 src/flytoday_mcp/flights.py、hotels.py、trains.py、buses.py 和 extras.py 中；每个工具都是带类型注解的 异步函数，并附有说明其适用场景的文档字符串。欢迎提交问题和 PR。

发布版本：更新 pyproject.toml 和 server.json 中的版本，然后推送 v* 标签。GitHub Actions 会运行测试、 发布到 PyPI 和 MCP Registry，并创建 GitHub Release。

相关服务

• iran-mcp：伊朗所有服务类 MCP 服务目录
• MrBilit MCP server：提供航班、火车、巴士、出租车和酒店服务
• Jabama MCP server：提供别墅、旅游团和活动服务
• Otaghak MCP server：提供别墅、小屋和公寓住宿服务

如果它为您省去了几次点击，点个星标就能帮助其他人找到它。

免责声明

本项目为非官方项目，与 Flytoday 无关联，也未获其认可。它为只读服务，使用 flytoday.ir 网站的公开接口，这些接口可能随时变更，恕不另行通知。请保持合理的请求频率。

作者

由 Sepehr Radmard（سپهر رادمرد）开发并维护。欢迎在 LinkedIn 上联系，或关注 GitHub 上的 @sepehr071，获取更多面向伊朗网站的 MCP 服务，所有服务均列于 iran-mcp。如果这为你节省了时间，欢迎为仓库点星，让更多人发现它。

许可证

MIT