MrBilit

mrbilit-mcp：面向 AI Agent 的 MrBilit MCP 服务

让你的 AI Agent 使用 MrBilit（مستربلیط）规划伊朗旅行。
这是一个非官方、只读的 MCP 服务，适用于 MrBilit——一家提供航班、火车、巴士、出租车和酒店预订服务的伊朗旅游网站：
通过 Claude、Cursor 或 Copilot，查找某个日期或整个月内价格最低的选项，查看座位、行李和退款规则，并比较酒店客房的准确价格。

面向 AI Agent · 为什么 · 功能介绍 · 快速开始 · 工具 · 工作原理 · 须知 · 常见问题 · 配置 · فارسی · 开发 · 相关服务 · 免责声明 · 许可证

适用于 AI Agent

• 内容： 非官方、只读的 MrBilit（مستربلیط）MCP 服务，适用于伊朗旅游网站，提供航班、火车、城际巴士、私人出租车和酒店查询。支持用波斯语和英语查询；价格以 Toman 计价。
• 安装： claude mcp add mrbilit -- uvx mrbilit-mcp（stdio 传输；需要 Python 3.10+ 和 uv）。
• 身份验证： 无需身份验证、API 密钥或账户。MRBILIT_MCP_PROXY（HTTP 代理）为可选项，仅当你的网络无法访问 MrBilit 的 API 服务器时才需要设置。
• 访问权限： 只读（全部 22 个工具均带有 readOnlyHint: true）。无需登录，也不支持锁定座位、预订或付款，因此调用工具前无需确认。
• 工具： 共 22 个，名称均以 mb_* 为前缀。先调用 mb_find_place 获取每次搜索所需的代码，再查询价格日历（mb_flight_price_calendar、mb_train_price_calendar、mb_bus_price_calendar）→ mb_search_flights / mb_search_trains / mb_search_buses → mb_flight_fare_details、mb_train_price 或 mb_bus_seats。酒店：mb_search_hotels → mb_hotel_rooms。
• 适用场景： 比较伊朗城市之间最便宜的飞机、火车、巴士或出租车，或比较酒店价格、座位和退款规则。
• 不适用场景： 需要预订、锁定座位或付款时（用户需在 mrbilit.com 上自行操作）。
• 输出： 精简的 JSON。价格位于 *_toman 字段中，日期采用公历 YYYY-MM-DD 格式，评分范围为 0-5。flight_id、class_id 和 bus_id 等 ID 来自最新搜索结果，且会过期。
• 机器可读信息： server.json；所有伊朗 MCP 服务目录：iran-mcp（TOOLS.md、servers.json、llms.txt）。

背景

MrBilit（mrbilit.com，مستربلیط）在同一平台销售航班、火车、城际巴士、私人出租车和酒店，但每种服务都有各自的搜索、日历和规则。要比较“飞机、火车还是巴士，哪天出发、选哪个座位”，需要加载十几个页面。使用 mrbilit-mcp 的 Agent 一次就能完成：

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

Agent： 调用 mb_search_flights(origin="THR", destination="MHD", date="2026-10-20")、 mb_train_price_calendar(origin=1, destination=191)、mb_search_buses(origin=11320000, destination=31310000, date="2026-10-20", sort="cheapest")

方式	最便宜的选项	出发时间	价格（Toman）
巴士	Peyk Saba VIP，德黑兰南站，剩余 17 个座位	21:00 出发，09:00 抵达	1,313,000
火车	当日最便宜的座位（价格日历）	用 mb_search_trains 列出	760,000
航班	Mehr Air MEH 4200，梅赫拉巴德，剩余 2 个座位	08:30 出发，09:30 抵达	11,856,000

火车最便宜；要我用 mb_search_trains 列出当天的列车和空余座位吗？

_{来自 2026-10-04 的真实工具输出；价格和座位随时可能变化。价格以 Toman 计价。}

能做什么

• 航班：国内和国际航班、单程或往返、多人价格，以及舱位／航空公司／直飞／时间筛选
• 最低价日期：查看未来几周内航班、火车和巴士的最低价日期，以及酒店的最低价入住夜晚
• 火车：所有有空位的席别、儿童／婴儿或整间包厢的确切价格，以及所有停靠站
• 巴士和出租车：客运站、公司、VIP、标有女性／男性座位的座位图，以及提供门到门服务的专车
• 替代方案：火车票售罄时，可选择中途换乘、附近车站、巴士路线和机场
• 酒店：有房且标明价格的住宿、城市内所有酒店、住客评分和评论、房间及确切价格
• 背景信息：当前网站公告、官方退款和行李规定、帮助中心指南、路线指南
• 只读设计：无需登录、不保留座位、不预订、不付款

示例提示词：

• “未来一个月内，德黑兰飞基什哪天最便宜？那趟航班的行李规定是什么？”
• “下周五从德黑兰到马什哈德的火车，2 名成人和 1 名儿童乘坐：哪些席别有座位？总价是多少？”
• “设拉子有哪些 4 星级酒店？从 20 号起住 3 晚，每晚低于 300 万托曼，并附上评论。”
• “周四德黑兰到大不里士的火车票已售罄，还有什么方式能到那里？”
• ارزان‌ترین اتوبوس VIP تهران به اصفهان فردا شب و صندلی‌های خالی آن؟
• ارزان‌ترین روز برای پرواز تهران به کیش در ماه آینده کدام است؟
• هتل‌های ۴ ستاره مشهد برای سه شب با قیمت دقیق اتاق‌ها را مقایسه کن.

快速开始

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

claude mcp add mrbilit -- uvx mrbilit-mcp

claude mcp add mrbilit -e MRBILIT_MCP_PROXY=http://127.0.0.1:8080 -- uvx mrbilit-mcp

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

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

codex mcp add mrbilit -- uvx mrbilit-mcp

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

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

然后用波斯语或英语提出上面的提示词。

工具

每次搜索都使用 mb_find_place 返回的代码：航班使用 IATA 代码（THR、MHD、ISTALL）， 火车使用车站 ID（德黑兰 1、马什哈德 191），巴士和出租车使用 8 位城市 ID（德黑兰 11320000），酒店使用 别名（mashhad、mashhad/enghelab）。

全部 22 个工具都标注了 readOnlyHint: true，并返回精简的结构化 JSON，不会让 Agent 的上下文过载。

工作原理

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  mrbilit-mcp  (runs on your machine)
      │
      │  HTTPS (REST, optional proxy)
      ├──────▶  flight.atighgasht.com, train.mrbilit.com, masir.mrbilit.com, bus.mrbilit.ir, hotel.mrbilit.ir
      └──────▶  content.mrbilit.ir, directus.mrbilit.ir, mrbilit.com (site lists, magazine)

mrbilit-mcp 在本地运行，并调用 mrbilit.com 网站使用的相同公共接口。中间没有托管服务，不需要 API 密钥，也不会将任何与你有关的信息发送到其他地方。

重要提示

• 所有工具中的价格均以托曼为单位（API 返回里亚尔；数值会除以 10），且始终位于名为 *_toman 的字段中。 航班的 price_toman 为每位成人的价格，total_toman 为全体乘客的总价；火车票按成人计价；巴士票按座位计价；出租车按车辆计价； 酒店价格为一间客房整个住宿期间的总价。
• 日期的输入和输出均采用公历 YYYY-MM-DD 格式；不接受过去的日期。时间使用当地时间：外国机场的航班时间采用该机场的当地时间，不过 API 会为每个航班时间标注 +03:30。
• 评分范围为 0–5；null 表示尚未评分。网站将酒店评分乘以 2，显示为 10 分制。
• ID 会过期：flight_id、class_id 和 bus_id 均来自最新的搜索结果。
• 售票时间范围：火车票约提前 18 天开售，巴士票约提前一个月开售。结果为空往往只是因为尚未开售。
• 往返行程：国内航班由两张独立机票组成（分列在两个列表中）；国际往返行程则按一个套餐计价。
• 酒店价格不受入住人数影响：选择 sleeps 容纳人数足够的客房，并为团体加订客房。
• 国内机场和火车站信息来自网站自带的列表，每次运行时获取一次；软件包中也附带了一份副本作为备用。
• 巴士和出租车城市信息来自 MrBilit 的实时城市列表，比软件包附带的副本更新。
• 不可信文本：评论（截取至 400 个字符）、规则、通知和指南均为网站内容；服务端会告知 Agent 将这些内容视为数据，而非指令。
• 不提供的功能：不支持登录或 OTP、座位预留、预订、支付、钱包、退款、优惠券、价格提醒或发布评论。请前往 mrbilit.com 预订。
• 回复大小：结果为精简的 JSON，默认限制在约 15 KB。
• 请求频率：由于 API 主机共用一台服务器，请求并发数最多为 2 次，并会加入短暂的随机延迟。

常见问题

npx @modelcontextprotocol/inspector uvx mrbilit-mcp

配置

安全与网络

• 只读：不登录、不使用 OTP，不占座、不预留、不下单、不付款、不使用钱包、不设置价格提醒，也不发布评论。 唯一的 POST 请求是网站在预订前自行发起的搜索和价格查询。
• 内容 CMS 的管理字段（created_by、updated_by）绝不会透传。
• 通过 curl_cffi 发送真实的 Chrome TLS 指纹和请求头；由于 API 主机共用一台服务器，因此同时最多发送两个请求，并在请求间加入短暂的随机延迟。
• 如果 MrBilit 返回机器人检查页面，服务可以在无头浏览器中清除检查：pip install mrbilit-mcp[browser]，然后运行 patchright install chromium。

波斯语：MrBilit MCP 服务

claude mcp add mrbilit -- uvx mrbilit-mcp

开发

git clone https://github.com/sepehr071/mrbilit-mcp && cd mrbilit-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline, against recorded responses
uv run python -m pytest -m live -q  # real API (set MRBILIT_MCP_PROXY if needed)
uv build

工具位于 src/mrbilit_mcp/places.py、flights.py、trains.py、buses.py、hotels.py 和 content.py 中；每个工具都是带类型标注的异步函数，并附有说明何时使用该工具的文档字符串。欢迎提交问题和 PR，尤其欢迎新增工具和修复 API 变更导致的问题。

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

相关服务

• iran-mcp：伊朗服务 MCP 服务目录
• flytoday-mcp：用于查询 Flytoday 上的航班、酒店、火车和巴士
• jabama-mcp：用于查询 Jabama 上的别墅、旅游和活动
• otaghak-mcp：用于查询 Otaghak 上的别墅、小屋和公寓住宿

如果这个工具帮您减少了点击操作，请点个星，帮助更多人发现它。

免责声明

本项目为非官方项目，与 MrBilit 无关联，也未获其认可。此服务仅供只读使用，并调用 mrbilit.com 网站的公开接口，这些接口可能随时变更，恕不另行通知。请合理控制请求频率。

作者

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

License

MIT