Tapsi Food

AI エージェント向け

• 概要： Tapsi Food（tapsi.food）向けの非公式 MCP サーバー（モデルコンテキストプロトコル）です。イランのフード・食料品配達サービスです。Snappfood ではありません。ペルシア語での検索が最も効果的です。価格の単位はトマンです。
• インストール： uvx tapsifood-mcp または claude mcp add tapsifood -- uvx tapsifood-mcp。トランスポートは stdio です。uv（Python 3.10 以降）が必要です。
• 認証： 不要です。API キーやアカウントも必要ありません。Tapsi Food はイラン国外の IP アドレスからの接続を保留します。VPN を使わずにイランから実行するか、イランを経由する HTTP プロキシを TAPSIFOOD_MCP_PROXY に設定してください。
• アクセス： 読み取り専用です。ログイン、カート、注文、支払いには対応していないため、ツールの呼び出し前に確認を求める必要はありません。
• ツール： 11 個あり、すべて tf_ で始まります。ほとんどのツールでは lat と long が必要です（tf_reviews、tf_find_location、tf_list_cities を除く）。 一般的な手順：tf_find_location -> tf_search_dishes -> tf_vendor_info（-> tf_menu、tf_reviews）。
• 利用する場面： ユーザーがテヘラン、マシュハド、シーラーズの住所周辺で料理やレストランを探したい場合、価格や料金を比較したい場合、メニューやレビューを確認したい場合、または割引を見つけたい場合に使用します。
• 利用しない場面： ユーザーが注文、支払い、ログインを希望する場合、または Tapsi Food のサービス対象外の都市について尋ねる場合は使用しないでください。
• 対応地域： テヘラン、マシュハド、シーラーズです。それ以外の地域では、API は 404 または OutOfCoverage を返します。
• 出力： コンパクトな JSON です。価格の単位はトマン、評価は 0～5 です。null と空のフィールドは省略されます（rating がない場合は未評価です）。メニューの説明は 100 文字、レビューのコメントは 250 文字で切り詰められます（全文を取得するには full_text: true を指定してください）。limit を最大値にしても、応答は約 15 KB 未満に収まります。
• 機械可読データ： server.json と、iran-mcp カタログ（TOOLS.md、servers.json、llms.txt）。

理由

デリバリーアプリで夕食を選ぶには、レストランを開いてメニューをスクロールし、配送料と最低注文金額を確認する必要があります。「近くで今営業中の一番安いハンバーガーはどれで、実際の総額はいくら？」と尋ねるには、何度もタップしなければなりません。tapsifood-mcp を使えば、エージェントが料理を見つけた後、指定した住所への配送料、包装料、最低注文金額を確認し、料理の価格から割引を差し引き、包装料と配送料を加えた実際の総額を回答します。

あなた： ヴァリアスル広場の近くで一番安いピザはどれですか？配送料を払う価値はありますか？

エージェント： 呼び出し tf_find_location -> tf_search_dishes(sort="cheapest") -> tf_vendor_info

営業中の候補のうち、価格と割引を含めた最安のものを一覧表示し、選んだレストランから指定した地点までの配送料、最低注文金額、営業状況を確認します。

できること

• ジオコーディング：地名や住所を座標に変換し、地点から住所を逆引きして、Tapsi Food が対応している都市を一覧表示します
• 料理を検索：配達先の近くで料理名を検索し、関連度、価格の安さ、割引額、評価、距離で並べ替えます
• レストランや店舗を検索：地点の近くで名前や料理のジャンルから検索します
• 閲覧：レストランや食料品店を、評価、配送料、最低注文金額、到着予定時間とともに表示します。料理のジャンル、割引、配達員、新規店舗で絞り込めます
• お得な情報をチェック：Tap Time（تپ تایم）のフラッシュセールと Food Shots（فودشات）の割引キャンペーンを確認します
• 最新のメニューを確認：すべての料理と価格、割引、在庫状況を表示します
• 注文前に店舗を確認：指定した地点までの配送料、最低注文金額、包装料、到着予定時間、営業中か休業中か、営業時間、住所、評価の内訳を確認します
• レビューを読む：注文した料理ごとの評価を確認します
• 読み取り専用設計：ログイン、カート、注文、支払いはありません

プロンプトの例：

• 「テヘランのエンゲラーブ広場の近くで、今営業中の一番安いハンバーガーを探してください。」
• 「近くで割引があり、配送料が30,000トマン未満のレストランはどこですか？」
• 「このレストランのメニューを表示して、最低注文金額を教えてください。」
• 「今、アザディ塔の周辺で利用できる Tap Time のフラッシュセールは何ですか？」
• 「このレストランの最新レビューを読んでください。配達に満足していますか？」
• ヴァリアスル広場の近くで一番安いピザはどれですか？
• 近くにある割引中のレストランを、配送料と最低注文金額とともに表示してください。
• 今日の Tap Time にはどんな料理がありますか？

クイックスタート

uv が必要です。API キーもアカウントも必要ありません。イランから実行するか、TAPSIFOOD_MCP_PROXY を追加してください（設定を参照）。

claude mcp add tapsifood -- uvx tapsifood-mcp
# behind a proxy that exits in Iran:
claude mcp add tapsifood -e TAPSIFOOD_MCP_PROXY=http://127.0.0.1:8080 -- uvx tapsifood-mcp

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

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

codex mcp add tapsifood -- uvx tapsifood-mcp

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

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

まず場所を指定します。tf_find_location または tf_list_cities で、ほかのツールに必要な lat と long を取得できます。ベンダーコードは 2y97wk のような形式です。

11 個のツールすべてに readOnlyHint: true が付与され、コンパクトな JSON を返します。

仕組み

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  tapsifood-mcp  (runs on your machine)
      │
      │  HTTPS
      └──────▶  api.tapsi.food   dishes, vendors, menus, reviews, deals

tapsifood-mcp はローカルで動作し、tapsi.food のウェブアプリと同じエンドポイントを呼び出します。間にホスト型サーバーはなく、API キーも必要ありません。リクエストは Chrome を装うクライアント経由で送信され、同時実行は最大 2 件で、少しランダムな間隔を設けます。GET の応答は 60 秒間キャッシュされ、タイムアウト、ネットワークエラー、5xx、429 が発生した場合は最大 2 回再試行します。また、通信先は api.tapsi.food のみです。読み取り専用です。

知っておくと便利なこと

• 価格の単位はトマンです。 API から送信される値をそのまま使用します。評価は 0～5 です。
• 配達可否は地点によって異なります。 メニュー、料金、配達範囲は、指定する緯度と経度によって変わります。HTTP 200 が返っても、その地点に配達するとは限りません。delivery_fee: null は配達範囲外を意味します。
• 配達範囲： テヘラン、マシュハド、シーラーズです。それ以外の地域では、フィードは 404 を返し、検索結果は見つからず、メニューには OutOfCoverage と表示されます。
• ネットワーク： Tapsi Food はイラン以外の IP アドレスからの接続を保留します（毎回の呼び出しがタイムアウトする場合は、それが原因です）。VPN を使わずにイラン国内から実行するか、TAPSIFOOD_MCP_PROXY を設定してください。システムのプロキシ環境変数は意図的に無視されます。
• 検索結果に表示されるのは営業中のベンダーのみです。 料理とベンダーの検索では、現在営業中のレストランのみが一覧表示されます（サイトも同じ動作です）。そのため、夜間は total が 0 になることがあります。tf_restaurants と tf_discounted_vendors には、open: false のフラグ付きで営業終了中のベンダーも表示されます。
• 検索インデックスの価格はメニューの価格と異なる場合があります。 tf_menu で確認してください。メニューとプロフィールで最低注文額が異なる場合があります。tf_vendor_info は両方（min_order、min_order_profile）を返します。
• 料理の並べ替え： top_rated、cheapest、biggest_discount で並べ替える対象は、最初の 100 件の一致結果であり、結果全体ではありません。
• 到着予定時間は上限です。 eta_max はサイトの「最大 N 分」にあたり、API は下限を返しません。
• レビュー： total は評価のみのレビューも含め、すべてのレビュー数を数えます。一覧表示されるのはコメント付きのレビューのみのため、1 ページあたりの件数が limit を下回ることがあります（has_more が続く間はページをめくってください）。投稿者名は意図的に省略されています。
• 一覧ページ： 1 ページ目にはフィルターやバナーのウィジェットも含まれるため、page_size より少ない数のベンダーが表示されます。
• 対応していない機能： ログイン、カート、注文、支払いには対応していません。クーポンはサイトの匿名 API では公開されていません。

よくある質問

npx @modelcontextprotocol/inspector uvx tapsifood-mcp

設定

فارسی

claude mcp add tapsifood -- uvx tapsifood-mcp

開発

git clone https://github.com/sepehr071/tapsifood-mcp && cd tapsifood-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline unit tests
uv run python -m pytest -m live -q  # real API; needs an Iranian IP
uv build

ツールは src/tapsifood_mcp/location.py、discover.py、vendor.py にあり、それぞれエージェントがいつ使用するかを説明する docstring を備えた、型付きの非同期関数です。Issue や PR を歓迎します。

リリースするには、pyproject.toml と server.json のバージョンを更新してから、v* タグを push してください。GitHub Actions がテストを実行し、PyPI と MCP Registry に公開して、GitHub Release を作成します。

関連サーバー

• iran-mcp：イランの各種サービス向け MCP サーバーのカタログ
• Snappfood と SnappMarket のフード・食料品配達向け Snapp MCP サーバー
• オンライン食料品購入向け Okala MCP サーバー
• イラン最大のオンラインストア向け Digikala MCP サーバー
• イランのショップ間で価格を比較する Torob MCP サーバー

免責事項

非公式のものであり、Tapsi とは提携関係になく、同社の承認も受けていません。読み取り専用で、予告なく変更される可能性がある tapsi.food ウェブアプリのエンドポイントを使用します。リクエスト頻度は適切な範囲に抑えてください。

作者

Sepehr Radmard（سپهر رادمرد）が開発・保守しています。LinkedIn でつながるか、GitHub の @sepehr071 をフォローすると、イランのウェブサイト向けのほかの MCP サーバーも確認できます。すべて iran-mcp に掲載されています。これによって時間を節約できた場合は、リポジトリにスターを付けていただくと、ほかの人にも見つけてもらいやすくなります。

ライセンス

MIT