Youtube Transcripts MCP

YouTube转录MCP服务器

一个独立的MCP服务器，用于下载、清理和总结YouTube视频字幕。

特性

• 🎥 使用yt-dlp下载YouTube字幕
• 🧹 干净的VTT格式（删除时间戳、HTML标签、重复项）
• 📝 生成包含阅读时间和关键主题的摘要
• 🚀 简单的命令行界面
• 📦 自给自足（无外部MCP服务器依赖关系）

先决条件

所需工具

安装yt-dlp

# Using pip
pip install yt-dlp

# Using pip3
pip3 install yt-dlp

# On macOS with Homebrew
brew install yt-dlp

# On Linux
pip install yt-dlp

安装

1. 安装依赖项：

   npm install

1. 构建项目：

   npm run build

配置

Claude桌面设置

将此添加到您的Claude Desktop配置中：

窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "youtube-transcripts": {
      "command": "node",
      "args": ["H:\\MCP\\yt-transcripts\\build\\mcp-server.js"]
    }
  }
}

重新启动克劳德桌面

关闭并重新打开Claude Desktop以使更改生效。

可用工具

使用示例

示例1：处理YouTube视频

问克劳德：

“处理此YouTube视频：https://www.youtube.com/watch?v=dQw4w9WgXcQ"

克劳德将：

1. 使用yt-dlp下载字幕
2. 清除VTT格式
3. 将清理后的文本保存到文件系统
4. 根据阅读时间生成摘要
5. 返回带有统计信息的成绩单

示例2：仅下载字幕

问克劳德：

“下载此视频的字幕：https://www.youtube.com/watch?v=dQw4w9WgXcQ"

示例3：清理现有VTT文件

问克劳德：

“清理此VTT文件：H:\\MCP\\captures dl\\video.VTT”

示例4：健康检查

问克劳德：

“在YouTube成绩单服务器上运行健康检查”

输出位置

默认情况下，所有文件都保存到：

H:\MCP\captions-dl\

使用这些工具时，可以指定自定义输出目录。

文件结构

H:\MCP\yt-transcripts\
├── README.md                   # This file
├── package.json                # Dependencies and scripts
├── tsconfig.json               # TypeScript configuration
├── mcp-server.ts              # Main MCP server
├── youtube-tools.ts           # Tool implementations
├── caption-cleaner.ts         # VTT cleaning utilities
├── file-manager.ts            # File operations
├── youtube-downloader.ts      # yt-dlp integration
└── build/                     # Compiled output
    ├── mcp-server.js
    ├── youtube-tools.js
    ├── caption-cleaner.js
    ├── file-manager.js
    └── youtube-downloader.js

NPM脚本

npm run build          # Compile TypeScript to JavaScript
npm run dev            # Watch mode - rebuild on file changes
npm run clean          # Remove build/ folder

故障排除

“找不到工具”错误

1. 检查路径 claude_desktop_config.json
2. 确保 build/mcp-server.js 存在（运行 npm run build)
3. 重新启动克劳德桌面

“服务器连接失败”

1. 确保yt-dlp已安装： yt-dlp --version
2. 检查Node.js版本： node --version （必须是v18或更高版本）
3. 验证Claude Desktop配置中的服务器路径

“没有可用的字幕”

1. 尝试其他带字幕的视频
2. 检查视频是私人的还是受限制的
3. 验证网络连接

好处

• 自足 -无外部MCP服务器依赖关系
• 简单 -直接实施，无桥接层
• 快速 -无代理开销或渐进式发现
• 易于维护 -代码库单一，结构清晰
• 与Claude Desktop配合使用 -纯MCP服务器

语言支持

目前仅配置为英文字幕。服务器自动搜索英文字幕(en.*)下载视频时。

许可证

麻省理工学院