Ytranscript Mcp

io.github.nnnoel由 GitHub 账号 nnnoel 发布v0.1.0更新于 Oct 25, 2026

YouTube transcripts for AI tools. No proxies needed; transcribes videos without captions.

概览

AI 生成的概览

本地 MCP 服务器,为 AI 助手获取 YouTube 视频转录文本,无字幕视频可用 AI 语音识别生成。

可以做什么
  • 根据 YouTube 链接或 11 位视频 ID 获取视频转录文本
  • 指定字幕语言轨道,或默认返回视频实际使用的语言
  • 返回纯文本或带时间戳的分行文本,可限制字符数并提示被截断的部分
  • 每次响应附带本次消耗的额度和当月累计用量
适用场景
适合让助手总结、引用、按时间戳检索或翻译 YouTube 视频内容,尤其是无字幕视频,或在 YouTube 屏蔽转录请求的云主机上运行。
运行要求
以 stdio 方式在本机运行,通常通过 npx 启动,需要 Node.js。需设置 YTRANSCRIPT_API_KEY 环境变量,可在服务商开发者页面获取,提供每月 50 单位的免费方案。需要访问服务商 API 的网络连接。
安装前请注意
API 密钥属于机密,通过环境变量传入。用量按单位计费:字幕转录 1 单位,AI 转录视频 15 单位,付费方案或按量加油包会产生费用。视频链接和 ID 会发送给第三方 yTranscript API。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Ytranscript Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

ytranscript-mcp

[npm] [ytranscript-mcp MCP server]

An MCP server that gives Claude, Cursor, VS Code, and other AI tools the transcript of any YouTube video.

  • Works from anywhere. Runs fine on AWS, Lambda, Vercel, n8n Cloud, and other cloud hosts. There are no proxies to buy and no IP bans to work around. YouTube blocks most cloud IPs for transcript requests; the yTranscript API handles that for you.
  • Handles videos without captions. If a video has no captions, it's transcribed with AI speech-to-text.
  • Returns the language actually spoken by default, including on auto-dubbed videos. Pass lang to pick a specific caption track.
  • Keeps long videos manageable. Choose plain text or timestamped lines, and cap the length so a two-hour video doesn't flood the model's context.

Setup

  1. Get a free API key at ytranscript.com/developers. The free plan includes 50 units a month, no card required.
  2. Add the server to your client using one of the configs below.

Claude Code

bash
claude mcp add ytranscript -e YTRANSCRIPT_API_KEY=yk_live_your_key -- npx -y ytranscript-mcp

Claude Desktop

Add this to claude_desktop_config.json. Open it from Settings → Developer → Edit Config.

json
{  "mcpServers": {    "ytranscript": {      "command": "npx",      "args": ["-y", "ytranscript-mcp"],      "env": { "YTRANSCRIPT_API_KEY": "yk_live_your_key" }    }  }}

Cursor

Add this to ~/.cursor/mcp.json, or to .cursor/mcp.json in a project:

json
{  "mcpServers": {    "ytranscript": {      "command": "npx",      "args": ["-y", "ytranscript-mcp"],      "env": { "YTRANSCRIPT_API_KEY": "yk_live_your_key" }    }  }}

VS Code

Add this to .vscode/mcp.json:

json
{  "servers": {    "ytranscript": {      "command": "npx",      "args": ["-y", "ytranscript-mcp"],      "env": { "YTRANSCRIPT_API_KEY": "yk_live_your_key" }    }  }}

Any other MCP client that runs stdio servers works the same way: run npx -y ytranscript-mcp with YTRANSCRIPT_API_KEY set.

Tool: get_transcript

ArgumentRequiredDescription
videoyesA YouTube URL (watch, youtu.be, shorts, embed) or an 11-character video ID
langnoLanguage code of the caption track to fetch, such as en or es. Omit it to get the video's original language
formatnotext (default) returns plain text. timestamped returns one line per segment with [m:ss] times
max_charactersnoCut the transcript at about this many characters. The response says how much was left out

Things to ask your assistant:

  • "Summarize this video: https://youtu.be/..."
  • "What does the speaker say about pricing, and at what timestamps?"
  • "Pull the transcript of this Spanish video and translate it to English."

Every response ends with the units used and your monthly total, so you can keep an eye on your quota.

Pricing

A transcript from captions costs 1 unit. A video without captions, transcribed with AI, costs 15 units. Failed requests are free.

PlanPriceUnits per month
Free$050
Starter$9/mo1,000
Developer$29/mo10,000
Scale$79/mo50,000

Need more in a given month? Pay-as-you-go packs add 1,000 units for $10, 5,000 for $40 or 20,000 for $120, on top of any plan. See ytranscript.com/developers for details.

Related

License

MIT

来源:README.md,提交 6bdc462

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.1.0最新Sep 24, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分