YouTube Subtitle MCP Server

MCP音视频

提供方 guangxiangdebizi · 包名 youtube-subtitle-mcp

音视频 stdio · 本地进程 会话登录 社区 / 第三方 ClaudeCursor
查看接入方式

一个用于提取YouTube视频字幕/转录的服务器,支持多种输出格式(SRT、VTT、TXT、JSON)以及多语言字幕。

一句话选型结论

按资料字段整理

YouTube Subtitle MCP Server 属于音视频类 MCP 服务器,stdio · 本地进程,会话登录,可直接接入 Claude、Cursor,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

字幕提取JavaScript混合部署视频处理多语言支持格式转换自动化工具

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
npx -y youtube-subtitle-mcp

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

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

音视频处理

裁剪、转码、拼接素材。

内容分发

把成品发到对应平台。

选择建议

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

值得选的地方

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

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
YouTube Subtitle MCP Server当前 未标注 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

服务器档案

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

详细介绍

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

🎬 YouTube字幕MCP服务器

一个模型上下文协议(MCP)服务器,用于获取YouTube视频字幕/转录,支持多种输出格式(SRT、VTT、TXT、JSON)。

✨ 特性

  • 🎥 从任何公开的YouTube视频中获取字幕
  • 📝 多种输出格式:SRT、VTT、TXT、JSON
  • ⚡ 两种部署模式:stdio(本地)和HTTP(服务器)
  • 🔧 使用npx进行零配置设置
  • 📊 完整的时间戳信息
  • 🚀 使用TypeScript进行生产准备
  • 🔥 使用youtubei.js构建,实现可靠稳定的字幕提取

🚀 快速开始

⭐ 方法1:stdio模式(建议本地使用)

无需配置! 只需使用npx:```bash
npx -y youtube-subtitle-mcp


或全局安装:```bash
npm install -g youtube-subtitle-mcp
youtube-subtitle-mcp

🌐 方法2:HTTP模式(用于服务器部署)```bash

Clone repository

git clone https://github.com/guangxiangdebizi/youtube-subtitle-mcp.git
cd youtube-subtitle-mcp

Install dependencies

npm install

Build

npm run build

Start HTTP server

npm run start:http


服务器将在以下时间启动 `http://localhost:3000`

## 📦 安装

### 为了发展```bash
# Clone repository
git clone https://github.com/guangxiangdebizi/youtube-subtitle-mcp.git
cd youtube-subtitle-mcp

# Install dependencies
npm install

# Build
npm run build

用于生产```bash

npm install -g youtube-subtitle-mcp


## 🔧 配置

### ⭐ stdio模式配置(推荐)

添加到MCP客户端配置文件中:

**克劳德桌面/光标配置:**

- 窗户: `%APPDATA%\Claude\claude_desktop_config.json`
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Linux: `~/.config/Claude/claude_desktop_config.json````json
{
"mcpServers": {
"youtube-subtitle": {
"command": "npx",
"args": ["-y", "youtube-subtitle-mcp"]
}
}
}

对于当地发展:```json
{
"mcpServers": {
"youtube-subtitle": {
"command": "node",
"args": ["C:/path/to/youtube-subtitle-mcp/build/index.js"]
}
}
}


### 🌐 HTTP模式配置```json
{
"mcpServers": {
"youtube-subtitle": {
"type": "streamableHttp",
"url": "http://localhost:3000/mcp",
"timeout": 600
}
}
}

🛠️ 工具:fetch_youtube_subtitles

参数

参数 类型 必填 说明 示例
url string ✅ 是 YouTube视频URL或视频ID https://www.youtube.com/watch?v=dQw4w9WgXcQ
format string ❌ 否 输出格式(默认:JSON) SRT, VTT, TXT, JSON
lang string ❌ 否 语言代码(默认:自动) zh-Hans, en, ja

支持的URL格式

  • 标准: https://www.youtube.com/watch?v=VIDEO_ID
  • 短: https://youtu.be/VIDEO_ID
  • 嵌入: https://www.youtube.com/embed/VIDEO_ID
  • 直接ID: VIDEO_ID

语言代码

  • zh-Hans -简体中文
  • zh-Hant -繁体中文
  • en -英语
  • ja -日语
  • ko -朝鲜语
  • es -西班牙语
  • fr -法语
  • de -德语

📝 使用示例

示例1:获取JSON格式的字幕(默认)```

Please fetch subtitles from this video:
https://www.youtube.com/watch?v=dQw4w9WgXcQ


### 示例2:获取SRT格式的字幕```
Please fetch subtitles in SRT format from:
https://www.youtube.com/watch?v=dQw4w9WgXcQ

示例3:获取特定语言字幕```

Please fetch Simplified Chinese subtitles in VTT format from:
https://www.youtube.com/watch?v=dQw4w9WgXcQ
Language code: zh-Hans


### 示例4:获取纯文本内容```
Please fetch plain text subtitles from:
https://youtu.be/dQw4w9WgXcQ
Format: TXT

📊 输出格式示例

JSON格式```json

[
{
"text": "Hello world",
"start": 0,
"end": 2000,
"duration": 2000
},
{
"text": "Welcome to YouTube",
"start": 2000,
"end": 5000,
"duration": 3000
}
]


### SRT格式```srt
1
00:00:00,000 --> 00:00:02,000
Hello world

2
00:00:02,000 --> 00:00:05,000
Welcome to YouTube

VTT格式```vtt

WEBVTT

00:00:00.000 --> 00:00:02.000
Hello world

00:00:02.000 --> 00:00:05.000
Welcome to YouTube


### TXT格式```text
Hello world
Welcome to YouTube
This is a subtitle example

🏗️ 项目结构```

youtube-subtitle-mcp/
├── src/
│ ├── index.ts # stdio mode entry (recommended for local use)
│ ├── httpServer.ts # HTTP mode entry (for server deployment)
│ └── tools/
│ ├── fetchYoutubeSubtitles.ts # Main tool implementation
│ ├── formatters.ts # Format converters (SRT/VTT/TXT/JSON)
│ └── utils.ts # Utility functions
├── build/ # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── README.md


## 📚 发展

### 构建```bash
npm run build

观看模式```bash

npm run watch


### 启动stdio模式```bash
npm run start:stdio

启动HTTP模式```bash

npm run start:http


### 自定义端口(HTTP模式)```bash
PORT=8080 npm run start:http

🐳 Docker部署

使用Docker```dockerfile

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build
EXPOSE 3000
CMD ["npm", "run", "start:http"]
``````bash

Build image

docker build -t youtube-subtitle-mcp .

Run container

docker run -d -p 3000:3000 --name youtube-mcp youtube-subtitle-mcp


### 使用Docker Compose```yaml
version: '3.8'
services:
youtube-subtitle-mcp:
build: .
ports:
- "3000:3000"
environment:
- PORT=3000
restart: unless-stopped
``````bash
docker-compose up -d

🚀 部署

PM2(过程经理)```bash

Install PM2

npm install -g pm2

Start service

pm2 start build/httpServer.js --name youtube-subtitle-mcp

View status

pm2 status

View logs

pm2 logs youtube-subtitle-mcp

Restart

pm2 restart youtube-subtitle-mcp

Stop

pm2 stop youtube-subtitle-mcp


## 🔍 api参考

### 健康检查(HTTP模式)

**端点:** `GET /health`

**答复:**```json
{
"status": "healthy",
"transport": "streamable-http",
"activeSessions": 0,
"name": "youtube-subtitle-mcp",
"version": "1.0.0",
"timestamp": "2024-01-01T12:00:00.000Z"
}

MCP端点(HTTP模式)

端点: POST /mcp

标题:

  • Content-Type: application/json
  • Mcp-Session-Id: (初始化后)

请求正文: JSON-RPC 2.0格式

⚠️ 备注

  1. 仅限公共视频:无法从私人或受限视频中获取字幕
  2. 需要字幕:视频必须有可用的字幕(自动生成或上传)
  3. 语言代码:如果指定的语言不存在,将返回错误
  4. 需要网络:需要稳定的网络连接才能访问YouTube
  5. 服务条款:请遵守YouTube的服务条款,仅用于研究/分析目的

❓ 常见问题解答

Q: 服务器已启动,但客户端无法连接?

A: 检查以下内容:

  1. 验证服务器是否正在运行:访问 http://localhost:3000/health
  2. 检查配置文件中的URL: http://localhost:3000/mcp
  3. 确保防火墙没有阻止端口3000
  4. 重新启动Cursor/Claude桌面

Q: 为什么我无法获取字幕?

A: 可能的原因:

  • 视频没有字幕
  • 视频是私人的或受地区限制的
  • 指定的语言代码不存在
  • 网络连接问题
  • 服务器网络无法访问YouTube

Q: 你支持自动生成字幕吗?

A: 是的,支持YouTube自动生成字幕。

Q: 我可以批量处理多个视频吗?

A: 当前版本一次处理一个视频。对于批处理,循环客户端的工具调用。

Q: 时间戳单位是什么?

A: JSON格式的时间戳以毫秒(ms)为单位。

Q: 我可以在远程服务器上部署吗?

A: 是的!只是:

  1. 在远程服务器上安装Node.js
  2. 克隆项目并运行 npm install
  3. 使用启动服务器 npm run start:http
  4. 在客户端配置中使用远程URL: http://your-server:3000/mcp
  5. 为了安全起见,建议使用HTTPS和反向代理(例如Nginx)

Q: 如何更改端口?

A: 两种方法:

  1. 环境变量: PORT=8080 npm run start:http
  2. 创建 .env 文件:添加 PORT=8080

🤝 贡献

欢迎投稿!请随时提交拉取请求。

📄 许可证

此项目根据Apache许可证2.0获得许可-请参阅 许可证 文件以获取详细信息。

👤 作者

陈兴宇

  • 领英: https://www.linkedin.com/in/xingyu-chen-b5b3b0313/
  • 电子邮件:guangxiangdebizi@gmail.com
  • github: https://github.com/guangxiangdebizi/
  • NPM: https://www.npmjs.com/~邢玉晨

🙏 致谢

  • 模型上下文协议 -MCP-SDK
  • youtubei.js -强大的YouTube API包装器,用于可靠的字幕提取

📮 支持

如果您有任何问题或建议,请创建 问题.


由...制作❤️ 陈兴宇

常见问题

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

在客户端按下面的安装命令接入:npx -y youtube-subtitle-mcp。对应的包名是 youtube-subtitle-mcp。装完在客户端配置里引用同一个包或端点。

YouTube Subtitle MCP Server 怎么在 Claude、Cursor 里配置?

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

YouTube Subtitle MCP Server 收费吗?

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

YouTube Subtitle MCP Server 需要 API Key 吗?

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

YouTube Subtitle MCP Server 支持哪些客户端?

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

YouTube Subtitle MCP Server 能提供哪些能力?

资料显示能力标签包括 格式转换、JavaScript、Claude、视频处理。具体工具清单以官方文档为准。

YouTube Subtitle MCP Server 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

YouTube Subtitle MCP Server 是本地还是远程?

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

热门专题

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

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