YouTube Transcript MCP Server

YouTube Transcript MCP 服务

基于 Model Context Protocol（MCP），在 Cloudflare Workers 上部署的高性能无服务器 YouTube 字幕提取服务。

概述

此 MCP 服务通过简单的 API，让 AI 助手能够获取 YouTube 视频的字幕。该实现结合了 kimtaeyoon83/mcp-server-youtube-transcript 中轻量级的字幕提取功能，以及 Cloudflare AI demos 中的远程 MCP 服务架构。

功能

• 无服务器部署：运行于 Cloudflare 全球边缘网络，延迟极低
• 灵活的 YouTube URL：支持多种 URL 格式和直接使用视频 ID
• 语言选择：获取不同语言的字幕（默认为英语）
• 针对边缘网络优化：响应速度极快（通常为 400-800ms）
• 精简实现：代码不到 300 行，易于维护
• SSE 传输：通过 Server-Sent Events 实现流式连接

可用工具

工具	描述	参数
get_transcript	提取 YouTube 视频字幕	url（必填）：YouTube 视频 URL 或 ID lang（可选，默认值："en"）：语言代码

在 Claude Desktop 中使用

安装

1. 打开 Claude Desktop，前往 Settings > Developer > Edit Config
2. 更新配置文件：

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-deployed-worker.workers.dev/sse"
      ]
    }
  }
}

3. 重启 Claude Desktop

提示词示例

Can you show me the transcript of this YouTube video? https://www.youtube.com/watch?v=dQw4w9WgXcQ

Extract the transcripts from this TED talk and summarize the key points: https://youtu.be/8S0FDjFBj8o

本地开发

前提条件

• Node.js 18 或更高版本
• Wrangler CLI（npm install -g wrangler）

设置

# Clone the repository
git clone https://github.com/yourusername/youtube-transcript-mcp-server.git
cd youtube-transcript-mcp-server

# Install dependencies
npm install

# Run locally
wrangler dev

使用 MCP Inspector 测试

1. 安装 MCP Inspector：

   npx @modelcontextprotocol/inspector
   

2. 在检查器中：

   • 将 Transport Type 设置为 SSE
   • 输入 http://localhost:8787/sse 作为 URL
   • 点击“Connect”

3. 使用不同的 YouTube URL 试用 get_transcript 工具

部署到 Cloudflare

# Deploy to Cloudflare Workers
wrangler deploy

技术实现

该服务采用精简、高效的代码库构建：

• YouTubeTranscriptMCPSqlite：具备字幕提取功能的核心 MCP Agent 实现
• McpServer：处理 MCP 协议交互
• MCP 协议集成：完整实现 Model Context Protocol

关键优化：

1. 高效的 URL 解析和验证
2. 尽量减少外部依赖
3. 妥善处理错误并提供详细错误消息
4. 通过 SSE 支持流式传输

致谢

• 使用 @modelcontextprotocol/sdk 构建
• 使用 youtube-captions-scraper 提取字幕
• 灵感来源：
  • kimtaeyoon83/mcp-server-youtube-transcript
  • Cloudflare AI Remote MCP Server demo

许可证

MIT