YouTube Transcript DL MCP Server

MCP音视频

提供方 jedarden

音视频 stdio · 本地进程 无需鉴权 社区 / 第三方
查看接入方式

一个支持多传输协议(stdio、SSE、HTTP)的YouTube视频字幕提取服务器,提供批量处理、多语言支持和多种输出格式。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

适用场景

字幕提取TypeScript本地部署视频处理多语言支持批量处理Docker部署

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
docker run -p 3001:3001 -p 3002:3002 ghcr.io/jedarden/yt-transcript-dl-mcp:latest --multi-transport

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

音视频处理

裁剪、转码、拼接素材。

内容分发

把成品发到对应平台。

选择建议

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

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

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

服务器档案

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

详细介绍

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

🎬 YouTube转录DL MCP服务器

一个全面的MCP(模型上下文协议)服务器,用于提取YouTube视频转录,支持多种传输方式(stdio、SSE、HTTP)、Docker部署和npm包分发。

✨ 特性

  • 🎯 多种运输支持:stdio、服务器发送事件(SSE)和HTTP
  • 📹 综合转录提取:单个视频、批量处理和播放列表
  • 📝 多种输出格式:文本、JSON和SRT字幕格式
  • 🚀 高性能:内置缓存和速率限制
  • 🐳 Docker就绪:完全支持集装箱化
  • 📦 npm包:易于安装和分发
  • 🧪 测试驱动开发:全面的测试套件,覆盖率超过90%
  • 🔧 TypeScript:完全类型安全和现代JavaScript功能

📦 安装

🔧 作为npm包```bash

npm install -g yt-transcript-dl-mcp


### 🛠️ 来源```bash
git clone
cd yt-transcript-dl-repo
npm install
npm run build

🐳 码头工人```bash

From GitHub Container Registry (recommended)

docker pull ghcr.io/jedarden/yt-transcript-dl-mcp:latest
docker run -p 3001:3001 -p 3002:3002 ghcr.io/jedarden/yt-transcript-dl-mcp:latest --multi-transport

Build from source

docker build -t yt-transcript-dl-mcp .
docker run -p 3001:3001 -p 3002:3002 yt-transcript-dl-mcp --multi-transport


## 🚀 用法

### 🖥️ MCP服务器

以不同模式启动MCP服务器:```bash
# Stdio mode (default)
yt-transcript-dl-mcp start

# SSE mode
yt-transcript-dl-mcp start --transport sse --port 3000

# HTTP mode
yt-transcript-dl-mcp start --transport http --port 3000

# With verbose logging
yt-transcript-dl-mcp start --verbose

💻 CLI工具

使用示例视频测试服务器:```bash

Test with a YouTube video

yt-transcript-dl-mcp test dQw4w9WgXcQ

Test with different language

yt-transcript-dl-mcp test dQw4w9WgXcQ --language es

Test with different format

yt-transcript-dl-mcp test dQw4w9WgXcQ --format srt


### 🔧 程序化使用```typescript
import { YouTubeTranscriptService } from 'yt-transcript-dl-mcp';

const service = new YouTubeTranscriptService();

// Extract single video transcript
const result = await service.getTranscript('dQw4w9WgXcQ', 'en', 'json');
console.log(result);

// Bulk processing
const bulkResult = await service.getBulkTranscripts({
videoIds: ['dQw4w9WgXcQ', 'jNQXAC9IVRw'],
outputFormat: 'json',
language: 'en'
});
console.log(bulkResult);

🛠️ MCP工具

服务器提供以下MCP工具:

get_transcript

从单个YouTube视频中提取文字记录。

参数:

  • videoId (必填):YouTube视频ID或URL
  • language (可选):语言代码(默认值:'en')
  • format (可选):输出格式-“text”、“json”或“srt”(默认值:“json”)

get_bulk_transcripts

从多个YouTube视频中提取文字记录。

参数:

  • videoIds (必填):YouTube视频ID或URL数组
  • language (可选):语言代码(默认值:'en')
  • outputFormat (可选):输出格式-“text”、“json”或“srt”(默认值:“json”)
  • includeMetadata (可选):在响应中包含元数据(默认值:true)

get_playlist_transcripts

从YouTube播放列表中的所有视频中提取转录。

参数:

  • playlistId (必填):YouTube播放列表ID或URL
  • language (可选):语言代码(默认值:'en')
  • outputFormat (可选):输出格式-“text”、“json”或“srt”(默认值:“json”)
  • includeMetadata (可选):在响应中包含元数据(默认值:true)

format_transcript

将现有成绩单数据格式化为不同格式。

参数:

  • transcript (必填):转录数据数组
  • format (必填):输出格式-“文本”、“json”或“srt”

get_cache_stats

获取缓存统计数据和性能指标。

clear_cache

清除转录缓存。

⚙️ 配置

🌍 环境变量```bash

Server configuration

PORT=3000
HOST=0.0.0.0
MCP_TRANSPORT=stdio

CORS settings

CORS_ENABLED=true
CORS_ORIGINS=*

Rate limiting

RATE_LIMIT_WINDOW=900000 # 15 minutes in ms
RATE_LIMIT_MAX=100

Caching

CACHE_ENABLED=true
CACHE_TTL=3600 # 1 hour in seconds
CACHE_MAX_SIZE=1000

Logging

LOG_LEVEL=info
LOG_FORMAT=simple


### 📝 配置文件

创建一个 `config.json` 文件:```json
{
"port": 3000,
"host": "0.0.0.0",
"cors": {
"enabled": true,
"origins": ["*"]
},
"rateLimit": {
"windowMs": 900000,
"max": 100
},
"cache": {
"enabled": true,
"ttl": 3600,
"maxSize": 1000
},
"logging": {
"level": "info",
"format": "simple"
}
}

🐳 Docker部署

🐙 Docker Compose```yaml

version: '3.8'

services:
yt-transcript-mcp:
build: .
ports:
- "3000:3000"
environment:
- NODE_ENV=production
- PORT=3000
- LOG_LEVEL=info
restart: unless-stopped
healthcheck:
test: ["CMD", "node", "dist/health-check.js"]
interval: 30s
timeout: 10s
retries: 3


### 健康检查

Docker容器包括内置的健康检查:```bash
# Check container health
docker ps
docker exec  node dist/health-check.js

发展

设置```bash

git clone
cd yt-transcript-dl-repo
npm install


### 运行测试```bash
# Run all tests
npm test

# Run tests with coverage
npm run test:coverage

# Run specific test suites
npm run test:unit
npm run test:integration
npm run test:e2e

# Watch mode
npm run test:watch

建筑```bash

Build TypeScript

npm run build

Development mode with watch

npm run dev

Linting

npm run lint
npm run lint:fix


### 测试MCP服务器```bash
# Test stdio transport
./scripts/test-stdio.sh

# Test with sample video
npm run test:sample

API文档

响应格式

所有成绩单回复均遵循以下结构:```typescript
interface TranscriptResponse {
videoId: string;
title?: string;
language: string;
transcript: TranscriptItem[];
metadata?: {
extractedAt: string;
source: string;
duration?: number;
error?: string;
};
}

interface TranscriptItem {
text: string;
start: number;
duration: number;
}


### 错误处理

服务器处理各种错误情况:

- **未找到视频**:返回元数据中有错误的空转录
- **私人视频**:通过描述性消息进行优雅的错误处理
- **速率限制**:内置延迟和重试逻辑
- **网络错误**:具有指数回退的自动重试

## 演出

### 基准测试

- **单视频提取**:\<5秒
- **批量加工**:每个视频\<2秒
- **并发请求**:10个并发请求的成功率超过90%
- **内存使用**:正常负载下小于512MB
- **缓存命中率**:重复请求为70%+

### 优化

- **LRU缓存**:可配置的TTL和大小限制
- **速率限制**:防止API滥用
- **并发处理**:针对批量操作进行了优化
- **内存管理**:高效的垃圾收集

## 故障排除

### 常见问题

1. **未找到视频**:检查视频是否公开并有字幕
1. **速率限制**:减少并发请求或增加延迟
1. **内存问题**:减少缓存大小或定期清除缓存
1. **网络错误**:检查互联网连接和防火墙设置

### 调试模式

启用调试日志记录:```bash
export LOG_LEVEL=debug
yt-transcript-dl-mcp start --verbose

日志

检查日志 logs/ 目录:bash tail -f logs/combined.log tail -f logs/error.log

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 为新功能编写测试
  4. 确保所有测试通过
  5. 提交拉取请求

代码的风格

  • 对所有代码使用TypeScript
  • 遵循ESLint配置
  • 编写全面的测试
  • 为公共API添加JSDoc注释
  • 使用常规提交消息

许可证

MIT许可证-有关详细信息,请参阅许可证文件。

支持

  • GitHub问题: 报告错误和功能请求
  • 文档: API完整文档
  • 示例: 使用示例

更新日志

v1.0.0

  • 初始版本
  • 具有stdio、SSE和HTTP传输的MCP服务器
  • 单视频和批量转录提取
  • Docker容器化
  • 全面的测试套件
  • TypeScript支持
  • 缓存和速率限制
  • 多种输出格式(文本、JSON、SRT)

常见问题

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

在客户端按下面的安装命令接入:docker run -p 3001:3001 -p 3002:3002 ghcr.io/jedarden/yt-transcript-dl-mcp:latest --multi-transport。装完在客户端配置里引用同一个包或端点。

YouTube Transcript DL MCP Server 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

YouTube Transcript DL MCP Server 收费吗?

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

YouTube Transcript DL MCP Server 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

YouTube Transcript DL MCP Server 能提供哪些能力?

资料显示能力标签包括 批量处理、Docker、视频处理、多语言支持。具体工具清单以官方文档为准。

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

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

YouTube Transcript DL MCP Server 是本地还是远程?

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

热门专题

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

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