Iran Software Downloads

iran-downloads-mcp：面向 AI Agent 的伊朗软件和游戏下载站 MCP 服务

让你的 AI Agent 在 Soft98、P30Download、Downloadly 和 VGDL 上查找软件和游戏（دانلود نرم‌افزار و بازی）。
这是一个非官方、只读的 MCP 服务，可搜索 Soft98、P30Download、Downloadly 和 VGDL 的公开页面，并且仅返回元数据：名称、版本、大小、类别、日期、简短描述、系统要求以及条目页面链接。

仅搜索元数据。 此服务绝不会下载或保存文件，也不会返回文件链接，更不会解析或绕过受限或带令牌的下载链接。它不会返回密码、破解说明或激活说明。这些网站上的许多条目都是破解、重新打包或以其他方式再分发的软件。你有责任核实所安装软件的许可证，并遵守所在地的法律。

面向 AI Agent · 缘由 · 功能 · 快速开始 · 工具 · 来源 · 工作原理 · 须知 · 常见问题 · 配置 · فارسی · 开发 · 相关服务

面向 AI Agent

• 功能： 用于在 Soft98（soft98.ir）、P30Download（p30download.ir）、Downloadly（downloadly.ir）和 VGDL（vgdl.ir）上搜索元数据的非官方 MCP 服务（模型上下文协议）。支持波斯语和英语文本。
• 安装： uvx iran-downloads-mcp 或 claude mcp add iran-downloads -- uvx iran-downloads-mcp。传输方式：stdio。需要 uv（Python 3.10+）。
• 身份验证： 无需身份验证，不需要 API 密钥或账号。可选设置 IRAN_DOWNLOADS_MCP_PROXY（HTTP 代理 URL 或逗号分隔的列表）；系统代理设置会被忽略。
• 访问权限： 只读。无需登录，也不提供下载，因此调用任何工具前都不需要确认。
• 工具： 共 4 个，均以 dl_ 为前缀：dl_list_sources、dl_search、dl_latest、dl_item。典型调用顺序：dl_list_sources（来源 ID 和分类 slug）-> dl_search 或 dl_latest -> 使用结果中的 url 调用 dl_item。
• 适用场景： 用户想按名称查找应用或游戏、查看最新内容，或在打开条目页面前了解版本、大小和系统要求。
• 不适用场景： 用户想要文件本身、直链、密码或破解文件。服务不会返回这些内容；请将用户引导至条目页面 url，并提醒他们核查许可证。
• 输出： 精简的 JSON。日期采用 ISO 格式（显示时间时使用 UTC）；Soft98 的波斯历日期会转换。摘要截断至 120 个字符，描述截断至 600 个字符。省略 null 和空字段。回复长度控制在约 15 KB 以内（per_source 最多为 5）。某个来源失败时，会列在 errors 下，其他来源仍会正常响应。页面缓存 3 分钟。
• 机器可读信息： server.json 和 iran-mcp 目录。

原因

对于许多想寻找应用、游戏或波斯语镜像的人来说，伊朗下载网站是首选，但每个网站都有自己的布局、搜索功能和分类树。想知道“Google Chrome 的最新版本是什么，大小是多少？”或“今天上传了哪些游戏？”，就得打开多个网站。使用 iran-downloads-mcp，Agent 可以一次搜索全部四个来源，并获取简短、便于比较的记录，而不是完整网页。

用户： VLC 有新版本吗？运行它有什么要求？

Agent： 调用 dl_search(query="VLC") -> dl_item(url=...)

它会列出各网站上匹配的条目及其版本，然后读取一个条目页面以获取大小和系统要求，并提供实际下载页面的链接。

每条回复都会精简到约 15 KB 以内，避免占满 Agent 的上下文。

功能

• 按名称搜索：一次调用即可在 Soft98、P30Download、Downloadly 和 VGDL 上搜索，每个来源最多返回 5 条结果
• 查看最新上传内容：按日期合并结果，也可按来源和分类筛选（Soft98 没有最新内容列表）
• 读取条目详情：名称、版本、大小、分类、日期、描述和系统要求（网站提供时）
• 列出来源：显示来源 ID、是否有最新内容列表，以及分类 slug
• 按设计只读：不提供下载、文件链接、密码或破解说明

提示词示例：

• “在伊朗下载网站上搜索 Google Chrome，并比较各版本。”
• “今天 P30Download 和 Downloadly 上传了什么内容？”
• “Downloadly 上的 Adobe Photoshop 有什么系统要求？”
• “VGDL 上最新的 PC 游戏。”
• آخرین نسخه نرم‌افزار ویندوز ۱۱ یا فتوشاپ در سافت۹۸ چیست؟
• جدیدترین بازی‌های اضافه‌شده به پی‌سی دانلود را نشان بده.
• حجم و سیستم مورد نیاز این برنامه در دانلودلی چقدر است؟

快速开始

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

claude mcp add iran-downloads -- uvx iran-downloads-mcp

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

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

codex mcp add iran-downloads -- uvx iran-downloads-mcp

[mcp_servers.iran-downloads]
command = "uvx"
args = ["iran-downloads-mcp"]

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

工具

全部 4 个工具均标注为 readOnlyHint: true。

来源

如果站点在标题中标注了版本，标题中就会包含版本（例如 Google Chrome 155.0.8059.85）；dl_item 会尽力返回 version。

工作原理

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  iran-downloads-mcp  (runs on your machine)
      │
      │  HTTPS, GET only
      ├──────▶  soft98.ir
      ├──────▶  p30download.ir
      ├──────▶  downloadly.ir
      └──────▶  vgdl.ir

iran-downloads-mcp 在本地运行，并读取这 4 个站点的公开页面、RSS 源和 WordPress REST 文章。中间没有托管服务，也无需 API 密钥。请求通过模拟 Chrome 的客户端发出，一次最多 4 个，并带有少量随机延迟；答案会缓存 3 分钟，失败的 GET 请求会重试，并且只允许通过 HTTPS 访问这 4 个主机。它不会读取或解码下载列表，也不会读取站点上用于隐藏链接的密钥。

需要了解的信息

• 仅提供元数据。 不提供文件下载、文件或镜像链接、密码、破解或激活说明。提及这些内容的句子会从摘要、描述和要求中删除。
• Soft98 仅支持搜索，其条目页面不提供文件大小。dl_latest 会跳过它。
• VGDL 仅返回标题、类别、日期和摘录。其列表中的内容均为重新打包的软件，因此许可免责声明完全适用。
• 日期： Soft98 的 Jalali 日期会转换为公历 ISO 日期；如显示时间，则采用 UTC。
• 版本：如果页面没有版本字段，则从标题中解析，因此请将其视为尽力而为的结果。
• 回复限制： 每次调用每个来源最多返回 5 条结果（per_source），摘要最多 120 个字符，描述最多 600 个字符，每次回复约 15 KB。
• 部分失败： 失败的来源（被屏蔽、宕机或显示机器人检测页面）会列在 errors 下，其他来源仍会正常返回结果。
• 网络： 测试中，从伊朗直连时，四个站点均有响应。通过土耳其代理出口时，Soft98、P30Download 和 Downloadly 有响应，而 VGDL 返回了机器人检测页面，而非 JSON。建议优先直连，或将 IRAN_DOWNLOADS_MCP_PROXY 设置为使用伊朗出口的代理。系统代理变量会被有意忽略。
• 使用拉丁字母名称搜索效果最佳。
• 不提供的功能： 不下载文件、不解析链接、不检查许可，也不支持其他下载站点。

常见问题

npx @modelcontextprotocol/inspector uvx iran-downloads-mcp

配置

波斯语：软件下载和游戏下载网站 MCP 服务

claude mcp add iran-downloads -- uvx iran-downloads-mcp

开发

git clone https://github.com/sepehr071/iran-downloads-mcp && cd iran-downloads-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  # calls the real sites
uv build

所有工具都位于 src/iran_downloads_mcp/downloads.py；每个工具都是带类型注解的异步函数，并附有说明 Agent 何时应使用它的文档字符串。欢迎提交问题和 PR。

发布：更新 pyproject.toml 和 server.json 中的版本，然后推送 v* 标签。GitHub Actions 会发布到 PyPI。

相关服务

• iran-mcp：所有伊朗服务 MCP 服务的目录
• iran-apps-mcp：伊朗应用商店
• iran-news-mcp：伊朗新闻
• torob-mcp：Torob 比价
• digikala-mcp：Digikala 商品

免责声明

本项目为非官方项目，与 Soft98、P30Download、Downloadly 或 VGDL 无关联，也未获其认可。本项目为只读服务，仅返回元数据和条目页面链接，并使用可能随时变更的公开页面。这些网站上的许多条目是破解或重新打包的软件：请自行核实许可。

作者

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

许可证

MIT