apify-utils-mcp

一个 MCP 服务器背后的四个小工具：PDF 文本、表格和 OCR、YouTube 缩略图 URL 和文件、体育比分和排名，以及 ATP/WTA 网球。

每个工具都是公共 Apify Actor 之上的一个轻量客户端。运行费用由 Apify 计入您自己的账户——请参阅定价。此服务器从不代理调用，从不查看您的令牌或结果，也从不代您支付任何运行费用。

安装

需要 uv 和一个免费的 Apify 令牌。

{
  "mcpServers": {
    "apify-utils": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/moonie0201/apify-utils-mcp", "apify-utils-mcp"],
      "env": { "APIFY_TOKEN": "apify_api_..." }
    }
  }
}

Related MCP server: PDF Tools MCP Server

工具

过滤器（page_range、teams、status、max_pages_per_pdf）在计费之前应用，因此范围狭窄的查询很便宜，而不是先返回大响应再自行过滤。每个付费工具都必须提供支出上限参数——这里无法启动无上限的运行。

定价

这里的任何 Actor 都不收取启动费，因此失败或一无所获的运行不产生任何费用。

实际示例：一份 2 页发票为 $0.0006，一本 100 页手册为 $0.03，20 页扫描件加 OCR 为 $0.06，100 个视频为 $0.50，今日 NBA 的 8 场比赛为 $0.016，500 场比赛摘要为 $2.00。

计费计入您自己的 APIFY_TOKEN 背后的 Apify 账户。支出上限参数不只是文档说明：服务器会将其转换为运行的 maxTotalChargeUsd，因此 Apify 会自行执行美元上限，并在达到上限时停止运行。由于 OCR 页面以十倍价格消耗同一个 max_pages 预算，max_pages=1000 在 ocr 关闭时意味着 $0.30，开启时意味着 $3.00，发送给 Apify 的上限会随之取对应值。Apify 拒绝低于 Actor 自身最低限额的上限（extract_pdf 为 $0.05，其余为 $0.10），因此非常小的运行会请求该下限——这是一个上限，而非收费：一份 2 页 PDF 仍然只需 $0.0006。

运行还会以 timeout=290 启动，位于 Apify 的 300 秒同步窗口内，因此运行绝不会比调用存活更久并在后台继续计费。

体育数据：请先阅读

非官方。 与 ESPN、华特迪士尼公司或任何联赛均无关联，未获其认可或赞助。数据来自 espn.com 自身使用的未认证 JSON 数据源；这些数据源没有文档，迪士尼关于 espn.com 的使用条款限制自动化访问，ESPN 可能随时更改或阻止访问，恕不另行通知——如果发生这种情况，Actor 会使运行失败且不收取任何费用，我们会在收到 ESPN 或迪士尼任何通知后的 48 小时内停止。比分、赛程和排名是事实；ESPN 的文章、视频和图片是 ESPN 的受版权保护内容，不包含在内。赔率是 ESPN 上显示的某家博彩公司的赛前盘口，仅供参考——不可用于投注。球队和联赛的名称及标志是其所有者的商标。移除请求： TAKEDOWN.md —— 48 小时内处理。

与 Actor 不同，这里的 include_odds 默认关闭。仅当您希望将赛前盘口复制到行中时才将其开启。timezone 默认为 UTC，且仅影响 dateLocal 字段；数据源的日期无论如何都是 UTC。

可用性。 所有四个 Actor 都是公开的：acotr_moonie/pdf-text-extractor、acotr_moonie/youtube-thumbnail-downloader、acotr_moonie/espn-sports-scraper 和 acotr_moonie/tennis-scores-scraper（两个体育列表自 2026-08-28 起）。每个工具都已针对其在线 Actor 进行了端到端验证。

leagues 接受：nfl、ncaaf、nba、wnba、ncaab、ncaaw、mlb、nhl、mls、nwsl、epl、championship、fa-cup、la-liga、serie-a、bundesliga、ligue-1、eredivisie、primeira-liga、liga-mx、saudi-pro-league、wsl、ucl、uel、uecl、nations-league、world-cup、copa-libertadores、atp、wta、pga、f1、ufc——或任何原始 ESPN 路径，例如 soccer/bra.1，如果未知则会作为免费错误行返回。

YouTube

仅作名义引用：本工具读取公共的 i.ytimg.com 缩略图 CDN 和 YouTube 的公共 oEmbed 端点。与 YouTube 或 Google 无关联，未获其认可或赞助；YouTube 名称和标志是 Google LLC 的商标。缩略图的版权归上传者或其许可方所有——本工具仅获取它们，并不授予您重新发布的许可。

它不会做什么

• 不做任何推断。 无法确定的值，字段为 null。

• extract_pdf 通过普通 GET 读取您指定的 PDF，无代理、无登录。您需自行遵守托管网站的条款和 robots 规则。所有者禁止复制文本的 PDF 始终会被跳过，并返回免费错误行，且无法覆盖。

• Markdown 标题和段落是基于字体大小和行间距的启发式判断，而非布局模型。表格提取只能识别带框线绘制的表格；无框线表格会保留在文本中。

• youtube_thumbnails 不展开播放列表或频道 URL，也不下载视频。

• 体育工具不包含新闻、文章、球员名单、伤病信息、运动员简介、逐回合文字直播或视频，也不包含 ITF 或挑战者网球。

开发

uv venv && uv pip install -e ".[dev]"
python -m pytest tests -q       # offline: httpx is monkeypatched, nothing is billed
ruff check . && ruff format --check .
python -m apify_utils_mcp --list-tools

链接

• Actor 源码，MIT：https://github.com/moonie0201/apify-utils

• 隐私政策：https://github.com/moonie0201/apify-utils/blob/main/PRIVACY.md

• 下架政策：https://github.com/moonie0201/apify-utils/blob/main/TAKEDOWN.md

披露

我构建了此项目，其背后的四个 Actor 是付费的。适配器代码是开放的，采用 MIT 许可。