Youtube Transcript Remote MCP

MCP音视频

提供方 JoeDupuis

音视频 stdio · 本地进程 OAuth 授权 社区 / 第三方 Cursor
查看接入方式

一个通过Google OAuth 2.0认证的YouTube字幕获取服务器,支持从视频ID或完整URL获取手动创建或自动生成的字幕,并可选择包含时间戳。

一句话选型结论

按资料字段整理

Youtube Transcript Remote MCP 属于音视频类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Cursor,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类音视频 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式支持远程部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

音视频
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

字幕获取Python本地部署视频处理GoogleOAuthYouTubeAPI文本提取

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
pip install -r requirements.txt

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
转写与字幕

把音视频转成文字和字幕。

音视频处理

裁剪、转码、拼接素材。

内容分发

把成品发到对应平台。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在音视频场景里让模型直接调用外部能力的人。
  • 已经在用 Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Youtube Transcript Remote MCP当前 未标注 stdio · 本地进程 支持远程部署 有 2026-05-17
Ableton MCP B7b69a6a 16 stdio · 本地进程 本地部署 有 2026-05-17
Mini Max MCP 8 SSE · 服务端推送 远程部署 有 2026-05-18
LocalAI 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Youtube E0eb3510 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Voicemode MCP 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

音视频
字段来自项目仓库与公开索引,中文说明由本站标注
提供方JoeDupuis上游标注的维护方 JoeDupuis
分类音视频本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.2 KB
来自项目仓库与上游目录的原文,未做删改

YouTube转录MCP服务器

一个MCP(模型上下文协议)服务器,通过Google OAuth 2.0身份验证提供YouTube转录获取功能。只有授权用户才能访问成绩单数据。

特性

  • 从视频ID或完整URL获取YouTube视频转录
  • 支持手动创建和自动生成的成绩单
  • 每个转录片段都包含可选的时间戳
  • 列出任何视频的可用成绩单
  • 基于电子邮件授权的Google OAuth 2.0身份验证
  • 从各种YouTube URL格式中自动提取视频ID

安装

  1. 克隆此存储库
  2. 安装依赖项:```bash
    pip install -r requirements.txt

## Google OAuth设置

### 1.创建谷歌云项目

1. 首选 谷歌云控制台
1. 创建新项目或选择现有项目
1. 启用Google Identity API(如果尚未启用)

### 2.创建OAuth 2.0凭据

1. 引导到 **API和服务>凭据**
1. 点击 **创建凭据>OAuth客户端ID**
1. 选择 **Web 应用程序** 作为应用程序类型
1. 添加授权重定向URI:
- 对于当地发展: `http://localhost:8080`
- 用于生产:应用程序的回调URL
1. 点击 **创建**
1. 下载客户端配置或记录您的 **客户端ID**

### 3.配置环境变量

1. 复制示例环境文件:```bash
cp .env.example .env
  1. 编辑 .env 并添加您的配置:```env
    GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
    AUTHORIZED_EMAILS=user1@gmail.com,user2@example.com

- `GOOGLE_CLIENT_ID`:您在谷歌云控制台上的OAuth 2.0客户端ID
- `AUTHORIZED_EMAILS`:允许使用该服务的以逗号分隔的电子邮件地址列表

## 运行服务器

### 选项1:Docker(推荐)

1. 使用docker compose构建并运行:```bash
docker-compose up -d
  1. 或者手动构建并运行:```bash
    docker build -t youtube-transcript-mcp .
    docker run -p 8000:8000 --env-file .env youtube-transcript-mcp

服务器将在以下位置可用: `http://localhost:8000/sse`

### 选项2:直接使用Python

默认情况下,服务器在端口8000上使用SSE(服务器发送事件)传输运行:```bash
python youtube_transcript_mcp.py

服务器将在以下位置可用: http://localhost:8000/sse

对于MCP Inspector或其他MCP客户端,请使用:

  • 运输类型: 上海证券交易所
  • 网址: http://localhost:8000/sse

可用工具

1. youtube_get_transcript

获取YouTube视频的文字记录。

参数:

  • video_input (字符串,必填):YouTube视频ID或完整URL
  • 示例: dQw4w9WgXcQ 或 https://youtube.com/watch?v=dQw4w9WgXcQ
  • cursor (整数,可选,默认值:0):分页的起始段索引

退货: 带时间戳的Markdown格式成绩单

分页是如何工作的:

  • 该工具在MCP响应大小限制(25000个字符)内自动适应尽可能多的段
  • 如果成绩单太长,它会返回一块,并告诉你还有更多
  • 使用 cursor 从响应中获取参数以获取下一个块

示例(从头开始):```json
{
"video_input": "dQw4w9WgXcQ"
}


**示例(获取下一页):**```json
{
"video_input": "dQw4w9WgXcQ",
"cursor": 250
}

响应格式:
当记录被分页时,响应包括:

  • Showing segments X-Y of Z:当前页面范围
  • Has more:是否有更多段要获取
  • Next cursor:用于获取下一批数据的值(仅当has_more为true时)

2. youtube_list_available_transcripts

列出YouTube视频的所有可用转录。

参数:

  • video_input (字符串,必填):YouTube视频ID或完整URL
  • auth_token (字符串,必填):谷歌OAuth 2.0 ID令牌

退货: 带语言信息的Markdown格式可用成绩单列表

例子:json { "video_input": "https://youtu.be/dQw4w9WgXcQ", "auth_token": "your-google-oauth-token" }

支持的URL格式

服务器会自动从以下URL格式中提取视频ID:

  • https://www.youtube.com/watch?v=VIDEO_ID
  • https://youtu.be/VIDEO_ID
  • https://www.youtube.com/embed/VIDEO_ID
  • https://www.youtube.com/v/VIDEO_ID
  • 直接视频ID: VIDEO_ID

身份验证流程

  1. 用户使用Google OAuth 2.0进行身份验证
  2. 客户端从谷歌获得ID令牌
  3. 客户端将ID令牌传递到 auth_token 参数
  4. 服务器使用Google验证令牌
  5. 服务器检查用户的电子邮件是否在授权列表中
  6. 如果获得授权,该工具将执行;否则,访问将被拒绝

错误处理

服务器为常见问题提供明确的错误消息:

  • 令牌无效/过期:“身份验证令牌无效或过期”
  • 未经授权的用户:“拒绝访问。用户X未被授权”
  • 视频不可用:“视频不可用。它可能是私人的、已删除的,或者ID不正确”
  • 无成绩单:“此视频没有可用的文字记录”
  • 成绩单已禁用:“此视频的文字记录已禁用”

安全考虑

  • OAuth令牌在每次请求时都会进行验证
  • 只有用户在 AUTHORIZED_EMAILS 列表可以访问工具
  • 客户端机密永远不应提交给版本控制
  • 商店 .env 安全,从不公开分享
  • 服务器是只读的,无法修改YouTube数据

局限性

  • 目前仅支持英文成绩单
  • 需要互联网连接来获取成绩单和验证令牌
  • 受限于YouTube的费率限制和可用性
  • 很长的转录本应使用分页,以保持在MCP响应大小限制范围内

许可证

麻省理工学院

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Youtube Transcript Remote MCP 怎么安装?

在客户端按下面的安装命令接入:pip install -r requirements.txt。装完在客户端配置里引用同一个包或端点。

Youtube Transcript Remote MCP 怎么在 Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Youtube Transcript Remote MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Youtube Transcript Remote MCP 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Youtube Transcript Remote MCP 支持哪些客户端?

资料标注支持 Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Youtube Transcript Remote MCP 能提供哪些能力?

资料显示能力标签包括 视频处理、Python、Cursor、文本提取。具体工具清单以官方文档为准。

Youtube Transcript Remote MCP 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Youtube Transcript Remote MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。