🚀 YouTube 简化版转录 MCP 服务器

这是一个高性能、无服务器版本的 YouTube 字幕提取服务，借助模型上下文协议（MCP），部署于 Cloudflare Workers 之上，能为用户高效提取 YouTube 视频字幕。

🚀 快速开始

此 MCP 服务器允许 AI 助手通过简单的 API 提取 YouTube 视频的字幕。实现结合了转录提取功能从kimtaeyoon83/mcp-server-youtube-transcript与远程 MCP 服务器架构来自Cloudflare AI 演示。

✨ 主要特性

• 无服务器部署：在 Cloudflare 的全球边缘网络上运行，延迟极低
• YouTube URL 灵活性：支持多种 URL 格式和直接视频 ID
• 语言选择：以不同语言提取字幕（默认为英语）
• 边缘优化：超快响应时间（通常 400 - 800 毫秒）
• 最小实现：不到 300 行代码，便于维护
• SSE 传输：实现服务器发送事件用于流式连接

📦 安装指南

使用 Claude 桌面

安装步骤

1. 打开 Claude 桌面，转到设置 > 开发者 > 编辑配置。
2. 更新你的配置文件：

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

3. 重启 Claude 桌面。

本地开发

先决条件

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

设置步骤

# 克隆仓库
git clone https://github.com/yourusername/youtube-transcript-mcp-server.git
cd youtube-transcript-mcp-server

# 安装依赖项
npm install

# 本地运行
wrangler dev

部署到 Cloudflare

# 部署到 Cloudflare Workers
wrangler deploy

💻 使用示例

示例提示

你能展示这个 YouTube 视频的字幕吗？ https://www.youtube.com/watch?v=dQw4w9WgXcQ

提取此 TED 演讲的字幕并总结关键点：https://youtu.be/8S0FDjFBj8o

使用 MCP 检查器测试

1. 安装 MCP 检查器：

npx @modelcontextprotocol/inspector

2. 在检查器中：
   • 设置传输类型为 SSE。
   • 输入 http://localhost:8787/sse 作为 URL。
   • 点击“连接”。
3. 使用 get_transcript 工具尝试不同的 YouTube URL。

📚 详细文档

可用工具

🔧 技术细节

服务器由简洁高效的代码库构建：

• YouTubeTranscriptMCPSqlite：核心 MCP 代理实现，具有转录提取功能。
• McpServer：处理 MCP 协议交互。
• MCP 协议集成：完整的 MCP 协议实现。

关键优化：

1. 高效的 URL 解析和验证。
2. 最小外部依赖项。
3. 正确的错误处理，带详细错误消息。
4. 通过 SSE 实现流式支持。

📄 许可证

[在此处添加许可证信息，如果适用。]

信用

• 使用 @modelcontextprotocol/sdk 构建。
• 使用 youtube-captions-scraper 进行字幕提取。
• 受到以下项目启发：
  • kimtaeyoon83/mcp-server-youtube-transcript
  • Cloudflare AI 演示