Tapsi Food

面向 AI Agent

• 简介： 面向 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，或将 TAPSIFOOD_MCP_PROXY 设置为出口位于伊朗的 HTTP 代理。
• 访问权限： 只读。无需登录，不能使用购物篮、下单或付款，因此调用任何工具前都不需要确认。
• 工具： 共 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，Agent 会先找到菜品，再查询餐厅配送到你所在地址的配送费、包装费和起送金额，并给出实际价格：菜品价格减去折扣，再加上包装费和配送费。

你： 瓦利亚斯尔广场附近最便宜的披萨是什么？配送费值不值得？

Agent： 调用 tf_find_location -> tf_search_dishes(sort="cheapest") -> tf_vendor_info

它会列出价格最低且正在营业的匹配结果及其折扣，然后查询选定餐厅配送到你所在位置的配送费、起送金额和营业状态。

功能

• 地理编码：将地点名称或地址转换为坐标，将坐标反查为地址，并列出 Tapsi Food 支持的城市
• 搜索菜品：按名称搜索配送范围内的菜品，并按相关性、价格最低、折扣最大、评分或距离排序
• 搜索餐厅和商店：按名称或菜系搜索地点附近的餐厅和商店
• 浏览：按评分、配送费、起送金额和预计送达时间浏览餐厅或杂货店，并按菜系、折扣、配送员或新商家筛选
• 查找优惠：Tap Time（تپ تایم）限时优惠和 Food Shots（فودشات）折扣活动
• 查看实时菜单：列出每道菜的价格、折扣和库存情况
• 下单前查询商家：配送到你所在位置的配送费、起送金额、包装费、预计送达时间、营业或歇业状态、营业时间、地址和评分分布
• 查看评论：包括每道已点菜品的评分
• 专为只读而设计：无需登录、不使用购物车、不下单、不付款

提示词示例：

• “找出德黑兰革命广场附近现在营业的最便宜汉堡。”
• “我附近哪些餐厅有折扣，且配送费低于 30,000 Toman？”
• “显示这家餐厅的菜单，并告诉我起送金额。”
• “现在阿扎迪塔附近有哪些 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 最多重试两次，并且只会与 api.tapsi.food 通信。它只读取数据。

注意事项

• 价格以 Toman 计价，与 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 会统计所有评价，包括仅有评分的评价；列表中只包含带评论的评价，因此一页可能少于 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 中；每个工具都是一个带类型注解的异步函数，并包含说明何时使用该工具的文档字符串。欢迎提交 Issue 和 PR。

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

相关服务

• iran-mcp：伊朗所有服务的 MCP 服务目录
• Snapp MCP 服务：用于 Snappfood 和 SnappMarket 的餐饮与杂货配送
• Okala MCP 服务：用于在线购买杂货
• Digikala MCP 服务：用于伊朗最大的在线商店
• Torob MCP 服务：用于比较伊朗各商店的价格

免责声明

本项目为非官方项目，与 Tapsi 无关联，也未获其认可。本项目为只读工具，使用 tapsi.food Web 应用的接口；这些接口可能在未通知的情况下发生变化。请合理控制请求频率。

作者

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

许可证

MIT