iran-mcp：把伊朗互联网装进 AI 智能体的「插件市场」

一句话概括

iran-mcp 是一个 MCP 插件市场（marketplace）：它自己不是一个模型、不是一个框架，而是一个索引 + 分发层——把 40 个针对伊朗本土网站的 MCP 服务器（合计 496 个工具）打包成 Claude Code 插件、Agent Skills、.mcp.json 与机器可读的 servers.json，让 Claude / Cursor / Copilot / Codex 能真正"逛"伊朗电商、分类信息、本地生活、医疗、股票、加密货币与法规数据库。

作者与起因

仓库作者是 Sepehr Radmard（@sepehr071），仓库 2026-10-11 建仓，到 10-27 已积累 162 star、18 fork，4 位贡献者（含 1 个 GitHub Actions bot），主体代码几乎全部出自作者一人之手。

起因很朴素：伊朗主流网站几乎都没有公开 API——Digikala（伊朗版淘宝/京东）、Torob（比价）、Divar（58 同城式分类信息）、Snappfood（外卖）、Paziresh24（医生预约）、TSETMC（德黑兰证券交易所）都只给自家 App 用；更麻烦的是同一件商品在不同页面一会儿以 Rial 报价、一会儿以 Toman 报价（1 Toman = 10 Rial）。作者的做法是逆向每个站点 Web App 真实调用的 undocumented API，测试之后包装成干净的 MCP 工具，并统一折算成 Toman 输出。

类比：像什么？

如果把它比作"应用商店"，那 40 个服务器就是 40 款 App，servers.json 就是商店的 API 清单，plugins/ 里每个目录就是带说明书（SKILL.md）的应用安装包，而 claude plugin marketplace add sepehr071/iran-mcp 就是 App Store 的添加源命令。用户不是去装一个"大程序"，而是按任务挑 3~10 个装上。

核心功能

• 覆盖广：电商（Digikala/TechlLife/MasterKala/Torob/Basalam）、服饰美妆、Khanoumi、Shopino、Banimode、外卖生鲜（Snappfood/Okala/Tapsi Food）、旅游住宿（MrBilit/Flytoday/Jabama/Otaghak）、医疗（Paziresh24/Doctoreto/ExirYab）、图书（Taaghche/Fidibo/30book）、教育（Maktabkhooneh）、应用商店（Cafe Bazaar/Myket）、行情（TGJU/伊朗黄金/Milli.gold/TSETMC）、加密货币（7 家交易所比价）、公共数据（16.8 万条法规 qavanin.ir、税务总局 e-invoice 与 VAT 税率、地震 IRSC/USGS/EMSC、10 家新闻源）。
• 工程规范：每个服务器是独立 git submodule、独立仓库、独立 PyPI 包，采用统一目录结构 src/<pkg>/http.py | registry.py | server.py | catalog.py，配离线 fixture 录盘测试 + -m live 真站测试，CI 自动发布到 PyPI 与 MCP Registry。
• 反爬对抗有章法：使用 curl-cffi 伪装 Chrome TLS 指纹与 sec-ch-ua 头，带 CDN cookie challenge 处理、限流退避（Retry-After）、代理池轮换（<NAME>_MCP_PROXY 支持逗号分隔多代理）、可选 patchright 无头浏览器兜底过机器人校验。
• 上下文成本优化：v1.5 版本号称单次调用 token 降低约 62%、工具列表缩小 19%。
• 给 Agent 读的文件：AGENTS.md（任务→服务器选型表 + 通用规则）、TOOLS.md（496 个工具一行一条）、llms.txt、servers.json（含每个工具的环境变量）、每个插件的 SKILL.md。
• 人机协作护栏：站点服务器一律 read-only——可搜、可比价，但不登录、不下单、不付款，只把购买链接交给用户；PayPing/Bale 写操作只作用于用户自己的账号且需确认；SwapWallet 的兑换/转账/提现必须用户在 Telegram 15 分钟内审批后才执行。

图：iran-mcp 的社交分享图（仓库 assets/social.png）

上手门槛

门槛低得反常：装了 uv 之后一条命令即可，无需 Python 环境、无需 API Key、无需账号：

claude plugin marketplace add sepehr071/iran-mcp
claude plugin install digikala@iran-mcp     # 单个服务器
claude plugin install iran-travel@iran-mcp  # 分类打包
claude plugin install iran-all@iran-mcp     # 全部只读站点服务器

非 Claude 生态用 npx skills add sepehr071/iran-mcp 装成 Agent Skills；任何 MCP 客户端可直接写 "command": "uvx", "args": ["digikala-mcp"]。两个官方托管服务（Pasavard、SwapWallet）直接以 HTTP URL 接入，无需本地安装。

但有两道现实门槛：地域限制——部分站点封禁境外 IP，需要伊朗出口代理；上下文预算——40 个服务器 496 个工具全开会撑爆上下文，README 自己就提示"按任务启用需要的服务器"。

争议与局限

1. 合规灰区：37 个服务器直连未公开的站点 API，作者自己也写明"非官方、不隶属于站点、接口可能随时变更"。是否违反服务条款、是否触发反爬法律风险，仓库没有正面回答。
2. 单点作者风险：核心代码基本由一人维护，40 个独立子仓库、496 个工具的升级、兼容与回归压力极大；贡献者仅 4 人（含 bot）。
3. 数据口径不统一：AGENTS.md 承认 tsetmc-mcp 用 Rial 报价、milligold-mcp 同时给出毫克/克/吨曼三种口径；iran-downloads-mcp 明确只返回条目页而不给下载链接。
4. 商业利益冲突：Pasavard 的链接是联盟返利链接，工具自己会标注，但使用者仍需知情。
5. 可用性依赖外部站点：一旦站点改接口或加强风控，对应服务器直接失效，项目没有兜底层。
6. 版本口径漂移：仓库描述写 "39 servers / 488 tools"，README 与 AGENTS.md 写 "40 servers / 496 tools"，PIFS 入库描述又用了前者——数字随版本滚动，静态引用容易过期。

行业意义

iran-mcp 不是孤例，但它把「MCP 作为分发单位」这件事推到了极致：一个仓库 = 一个市场，而不是一个服务器。这个模式正在被复用——同期大量垂直领域 MCP 仓库涌现（Archicad、CalDAV、股票、cve-intel 等），而把"选型表 + 打包 + 一键安装 + Agent 友好文档"做成一等公民的，确属少数。

它也折射出一个更重要的趋势：AI 智能体的落地瓶颈正在从模型能力转向"世界接口"。模型再强，如果接不上 Digikala 的实时报价、接不上德黑兰交易所的盘口、接不上 16.8 万条伊朗法规正文，就等于没有落地能力。iran-mcp 用"逐站点逆向 undocumented API"这种最笨也最扎实的方式补齐了 40 个接口的缺口——这种活儿短期只能由愿意脏手的人干。

从数据看，仓库自 10 月 11 日创建到 10 月 27 日仅 16 天就拿到 162 star、18 fork、4 位贡献者，在 MCP 生态里属于相当快的冷启动速度。

图：iran-mcp 下最常用的 digikala-mcp 子服务器横幅（各服务器同款风格）

结论

iran-mcp 用 16 天时间证明了一件事：AI Agent 的护城河不在模型，在"有没有人愿意替它把脏活干完"。它把 40 个伊朗站点的逆向工程、限流对抗、数据口径统一、工具裁剪和安全护栏全部封装进一个可以一行命令安装的市场，是目前垂直领域 MCP 生态里工程完成度最高、组织最完整的样板之一。

对国内团队的启示同样直接：垂直行业的 AI 智能体要真正跑起来，第一步往往不是选模型，而是把行业里那十几个"只有网页没有 API"的平台逐个接进来——这件事工程量巨大，但也正是壁垒所在。