mcpField
R
rippr

rippr

本地服务
github.com/mrslbt媒体与设计413 周前更新

关于 rippr

rippr 为用户和 AI Agent 提取 YouTube 字幕,提供网站、Chrome 扩展和本地 MCP 服务。它支持纯文本、结构化 JSON 和 Markdown,并采用多种提取方式。

主要功能

  1. 01提取 YouTube 字幕
  2. 02输出纯文本、JSON 或 Markdown
  3. 03通过网站或 Chrome 扩展使用
  4. 04将 MCP 字幕保存到本地目录
  5. 05采用多种提取策略

适用场景

  1. 01从 YouTube URL 获取字幕
  2. 02浏览 YouTube 页面时提取字幕
  3. 03准备适合切分和嵌入的字幕文本
  4. 04向 AI 客户端提供带时间戳的字幕数据

MCP 相关

本地 stdio MCP 服务连接兼容的桌面客户端,并返回已保存字幕的文件路径。字幕存储在 `~/rippr/transcripts/`。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"rippr": {
"command": "npx",
"args": [
"-y",
"rippr-mcp"
]
}
}
}
启动命令npx -y rippr-mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmrippr-mcp1.3.0

工具

1

收录的工具列表 · 更新于 3 周前

参数类型必填说明
urlstring是YouTube 视频 URL。支持任何 YouTube URL 格式(watch、youtu.be、embed、shorts 或 11 位纯 ID)。
formatenum否保存的文件格式。'text' 会写入带 YAML frontmatter 和连续字幕块的 Markdown 文件(最适合 RAG/LLM)。'segments' 会写入带时间戳片段的 JSON 文件(最适合章节标记和精确引用)。默认值:text。text | segments
save_pathstring否可选的字幕保存位置覆盖值。可以是绝对路径、~/-相对路径、目录(文件名自动生成)或完整文件路径。保存到默认目录之外时,返回的 resource_link 仍指向已保存的文件,以便之后读取。默认值:~/rippr/transcripts/<slug>_<videoId>.<ext>
return_textboolean否为 true 时,在工具响应中通过 resource_link 同时包含完整字幕文本。默认值:false。仅对短视频片段或用户明确要求内联字幕时使用 true。

详细介绍

rippr 图标

rippr

为人类和 AI Agent 提取 YouTube 字幕文本。

npm npm 下载量 Manifest V3 MIT 许可证 LobeHub MCP Glama MCP

网站 · Chrome 网上应用店 · MCP 服务(npm)


使用 rippr 的三种方式

🌐 网站 — rippr.me

粘贴 YouTube URL,即可获取字幕文本。文本整洁,无需注册。

🧩 Chrome 扩展程序 — Chrome 网上应用店

在任意 YouTube 页面上一键提取字幕文本。支持多种输出格式(RAG、JSON、Markdown)。

🤖 MCP 服务 — npm

将 rippr 连接到 Claude、Cursor 或任何兼容 MCP 的客户端。每份字幕文本都会保存到 ~/rippr/transcripts/,并将文件路径返回给模型。

仅适用于桌面客户端。 rippr 以本地 stdio 进程运行,因此可与 Claude Desktop、Claude Code CLI 和 Cursor 配合使用。它无法与云端托管的客户端配合使用(网页上的 claude.ai、Claude 手机应用,或手机/网页端的 Claude Code),因为这些客户端无法启动本地进程。

npx rippr-mcp

添加到 Claude Desktop(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "rippr": {
      "command": "npx",
      "args": ["-y", "rippr-mcp"]
    }
  }
}

然后询问:“提取这个 YouTube 视频的字幕文本:[url]”。有关完整的工具列表,请参阅 mcp/README.md。


输出格式

  • RAG (.txt) — 单个连续文本块,针对分块和嵌入进行了优化
  • 结构化 (.json) — 带时间戳的片段及元数据
  • 易读 (.md) — 带标题和格式的 Markdown

工作原理

采用多策略提取,确保最大可靠性:

  1. Innertube API — YouTube 的内部播放器 API(Android 客户端)
  2. HTML 抓取 — 从页面源代码解析 ytInitialPlayerResponse
  3. 字幕面板 — 作为最后手段,打开 YouTube 内置的字幕面板

支持以多种格式解析字幕 XML(srv3、timedtext、JSON3)。遇到暂时性故障时,会通过指数退避策略重试。

隐私

完全在你的设备上运行。不会向外部服务发送数据。无需账户,不跟踪用户。仅与 YouTube 自身的 API 通信。

更多 MCP

MCP功能
Japan UX面向 AI 的日式 UX 规则:表单、敬语、排版、信任信号
Rakuten搜索乐天的市场、图书和酒店
XenditXendit 支付 API:发票、付款、余额

免责声明

Rippr 是一款非官方的社区开发工具。它与 YouTube 或 Google LLC 无关,也未获得其认可或赞助。YouTube 是 Google LLC 的商标。

Rippr 通过 YouTube 自有应用使用的端点访问公开的 YouTube 字幕数据。使用本工具须遵守 YouTube 的服务条款,风险由您自行承担。对于因使用本工具而导致的下架、速率限制、账号处置或任何其他后果,作者概不负责。

如果 YouTube 更改其内部 API,导致无法提取数据,本工具可能会在不另行通知的情况下停止工作。如需长期用于生产环境,请考虑使用官方的 YouTube Data API v3 和 API 密钥(此软件包目前不支持)。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。