MrBilit

mrbilit-mcp：AI エージェント向け MrBilit MCP サーバー

AI エージェントが MrBilit（مستربلیط）でイラン旅行を計画できるようにします。
MrBilit は、飛行機、列車、バス、タクシー、ホテルを扱うイランの旅行サイトです。これは非公式の読み取り専用 MCP サーバーです。
Claude、Cursor、Copilot から、特定の日または1か月間の最安値を探したり、座席、手荷物、払い戻しのルールを確認したり、正確な料金でホテルの客室を比較したりできます。

AI エージェント向け · 理由 · できること · クイックスタート · ツール · 仕組み · 知っておくとよいこと · よくある質問 · 設定 · ペルシア語 · 開発 · 関連サーバー · 免責事項 · ライセンス

AI エージェント向け

• 概要： MrBilit（مستربلیط）向けの非公式な読み取り専用 MCP サーバーです。MrBilit はイランの旅行サイトで、航空券、鉄道、都市間バス、プライベートタクシー、ホテルを扱っています。ペルシャ語と英語で検索でき、価格の単位はトマンです。
• インストール： 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 を使えば、エージェントが一度に調べられます。

あなた： 10 月 20 日にテヘランからマシュハドへ行く最安の方法は？

エージェント： 以下を呼び出します 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")

移動手段	最安の選択肢	出発時刻	料金（トマン）
バス	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 時点の実際のツール出力です。料金と空席数は常に変動します。料金の単位はトマンです。}

できること

• フライト：国内線・国際線、片道・往復、複数人分の料金、座席クラス・航空会社・直行便・時間帯の絞り込み
• 最安日：数週間先までのフライト・列車・バスの最安日と、ホテルの最安宿泊日
• 列車：空席のあるすべてのクラス、子ども・幼児・個室全体の正確な料金、すべての停車駅
• バスとタクシー：ターミナル、運行会社、VIP、女性・男性用座席を表示する座席表、ドアツードアの専用車
• 代替案：列車が満席の場合の乗り換え1回の旅程、近隣の駅、バス路線、空港
• ホテル：料金付きの空室、都市内のすべてのホテル、宿泊者の評価とレビュー、客室と正確な料金
• コンテキスト：サイトの最新のお知らせ、公式の返金・手荷物規定、ヘルプセンターのガイド、ルートガイド
• 読み取り専用の設計：ログイン、座席の仮押さえ、予約、支払いは行いません

プロンプトの例：

• 「来月のテヘランからキーシュへの最安のフライト日はいつですか？そのフライトの手荷物規定も教えてください。」
• 「来週金曜日に大人2人と子ども1人でテヘランからマシュハドへ行く列車について、空席のあるクラスと合計料金を教えてください。」
• 「シーラーズで20日から3泊、1泊300万トマン未満の4つ星ホテルを、レビューと一緒に教えてください。」
• 「木曜日のテヘランからタブリーズへの列車が満席です。ほかに行く方法はありますか？」
• ارزان‌ترین اتوبوس 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を返すため、エージェントのコンテキストがあふれることはありません。

仕組み

  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 は大人 1 名分、total_toman はグループ全体の料金です。列車は大人 1 名分、バスは座席 1 席分、タクシーは車 1 台分、ホテルは 1 室あたりの全宿泊料金です。
• 日付は入出力ともにグレゴリオ暦の YYYY-MM-DD 形式です。過去の日付は拒否されます。時刻は現地時刻です。海外の空港でのフライト時刻はその空港の現地時刻ですが、API はすべてのフライト時刻に +03:30 を付けます。
• 評価は 0～5 です。null は評価なしを意味します。サイトではホテルの評価を 2 倍して 10 点満点で表示します。
• ID には有効期限があります。flight_id、class_id、bus_id は新しい検索で取得してください。
• 販売期間：列車は約 18 日先、バスは約 1 か月先まで販売されます。検索結果が空でも、多くの場合は「まだ販売されていない」という意味です。
• 往復：国内線は往路と復路が別々のチケット（2 つのリスト）です。国際線の往復は 1 つのパッケージとして料金が提示されます。
• ホテルの料金は宿泊人数によって変わりません。sleeps が人数に合う部屋を選び、グループの場合は部屋数を増やしてください。
• 国内の空港と鉄道駅は、サイト独自の同梱リストを実行ごとに 1 回取得します。取得できない場合に備えて、パッケージにもリストのコピーが含まれています。
• バスとタクシーの都市は MrBilit の最新の都市リストから取得するため、同梱されたコピーより新しい情報です。
• 信頼できないテキスト：レビュー（400 文字で切り詰められます）、規則、通知、ガイドはサイトのコンテンツです。サーバーは、これらを指示ではなくデータとして扱うようエージェントに伝えます。
• 対応していない機能：ログイン、OTP、座席の確保、予約、支払い、ウォレット、払い戻し、クーポン、価格アラート、レビュー投稿には対応していません。予約は mrbilit.com で行ってください。
• 応答サイズ：結果はコンパクトな JSON で、デフォルトでは約 15 KB に収まるようになっています。
• リクエスト頻度：API ホストが 1 台のサーバーを共有しているため、短いランダムな間隔を空けて、同時リクエスト数を最大 2 件に制限しています。

よくある質問

npx @modelcontextprotocol/inspector uvx mrbilit-mcp

設定

安全性とネットワーク

• 読み取り専用です。ログインや OTP、座席確保、予約、注文、支払い、ウォレット、価格アラート、レビュー投稿は行いません。 POST リクエストは、サイトが予約前に行う検索と価格照会のみです。
• コンテンツ CMS の管理者フィールド（created_by、updated_by）は一切受け渡しません。
• 実際の Chrome TLS フィンガープリントとヘッダー（curl_cffi 経由）を送信します。また、API ホストが同じサーバーを共有しているため、短いランダムな遅延を挟みながら、一度に最大 2 件のリクエストを送信します。
• MrBilit がボットチェックページを表示した場合、サーバーはヘッドレスブラウザーで解除できます。pip install mrbilit-mcp[browser] を実行し、その後 patchright install chromium を実行してください。

ペルシア語：MCP サーバー MrBilit

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 にあります。それぞれ、エージェントがどのようなときに使うかを説明する docstring を備えた、型注釈付きの非同期関数です。Issue や PR は歓迎します。特に、新しいツールや API の変更への対応を歓迎します。

リリースするには、pyproject.toml と server.json のバージョンを更新し、v* タグを push します。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