Youtube Transcript Remote MCP Server

🌟 功能

• 无需本地设置：无需安装，可直接通过云端使用
• 随处访问：支持 Claude 桌面版、移动版和网页版
• 智能缓存：使用 Cloudflare KV 高效缓存，快速响应
• 多语言支持：提取不同语言的字幕
• 错误处理：完善的错误处理机制，并提供易于理解的提示
• 分析：内置请求跟踪和使用情况分析
• URL 格式灵活：支持所有 YouTube URL 格式（youtube.com、youtu.be、m.youtube.com 等）

🚀 快速开始

选项 1：使用我们托管的服务（推荐）

最简单的入门方式——只需将我们的公共服务添加到 Claude Desktop：

Claude Desktop 用户

1. 打开 Claude Desktop 设置

   • 点击菜单栏中的“Claude” → “Settings”
   • 转到“Developer”选项卡
   • 点击“Edit Config”

2. 添加 MCP 服务配置

   将以下内容添加到 claude_desktop_config.json：

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

3. 重启 Claude Desktop

   保存配置文件后，重启 Claude Desktop 以加载服务。

4. 验证安装

   在聊天界面中查找工具图标（🔧）。你应该能看到可用的 get_transcript 工具。

选项 2：自行部署

想运行自己的实例？只需单击一次，即可部署到 Cloudflare Workers：

或者手动部署：

git clone https://github.com/ergut/youtube-transcript-mcp
cd youtube-transcript-mcp
npm install
npm run deploy

其他 MCP 客户端

此服务支持标准 MCP 协议，可与任何兼容客户端搭配使用：

• 公共服务 URL：https://youtube-transcript-mcp.ergut.workers.dev/sse
• 传输方式：服务器发送事件（SSE）或 HTTP
• 身份验证：无需验证（公共服务）

📖 使用示例

基本字幕提取

Extract the transcript from this YouTube video: https://www.youtube.com/watch?v=dQw4w9WgXcQ

多语言支持

Can you get the transcript of this video in Turkish: https://youtu.be/VIDEO_ID

Extract the Spanish transcript from: https://www.youtube.com/watch?v=VIDEO_ID

支持的 URL 格式

此服务会自动处理所有 YouTube URL 格式：

• https://www.youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• https://m.youtube.com/watch?v=VIDEO_ID
• https://www.youtube.com/live/VIDEO_ID
• https://www.youtube.com/embed/VIDEO_ID
• https://www.youtube.com/shorts/VIDEO_ID
• 国际域名（youtube.co.uk、youtube.de 等）

所有跟踪参数（如 ?si=、&t= 等）都会自动移除。

🛠 可用工具

get_transcript

从 YouTube 视频 URL 提取字幕。

参数：

• url（必填）：任意格式的 YouTube 视频 URL
• language（可选）：字幕的语言代码（例如，'en'、'es'、'fr'）。默认为 'en'。

使用示例：

{
  "name": "get_transcript",
  "arguments": {
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "language": "en"
  }
}

🔧 高级配置

调试日志

如需启用详细日志以排查问题：

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

调试日志将创建在 ~/.mcp-auth/{server_hash}_debug.log 中。

仅使用 HTTP 传输

如需强制使用 HTTP 传输而非 SSE：

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://youtube-transcript-mcp.ergut.workers.dev/mcp",
        "--transport",
        "http-only"
      ]
    }
  }
}

📊 服务信息

• 托管平台：Cloudflare Workers
• 缓存：Cloudflare KV 为成功提取的字幕缓存 7 天
• 速率限制：内置重试逻辑，并采用指数退避机制
• 正常运行时间：依托 Cloudflare 全球网络，服务可用性超过 99.9%
• 响应时间：缓存内容通常少于 3 秒，新请求少于 10 秒

🚨 错误处理

服务会针对常见问题提供清晰的错误消息：

• "Invalid YouTube URL provided"：无法识别 URL 格式
• "No transcript available for this video"：视频没有字幕／转录文本
• "Video not found or private"：视频为私有、已删除或不存在
• "Service temporarily busy, try again in a few minutes"：YouTube 限流
• "Transcripts are disabled for this video"：创作者已关闭字幕

🌍 语言支持

服务支持 YouTube 提供转录文本的所有语言。常见语言代码：

• en - 英语（默认）
• tr - 土耳其语
• es - 西班牙语
• fr - 法语
• de - 德语
• it - 意大利语
• pt - 葡萄牙语
• ja - 日语
• ko - 韩语
• zh - 中文

🔒 隐私与安全

• 无需身份验证：公开服务，方便使用
• 不存储数据：仅为提升性能而临时缓存转录文本
• 不处理个人信息：仅处理 YouTube 视频 ID 和转录文本
• 仅使用 HTTPS：所有通信均已加密
• 已启用 CORS：支持基于 Web 的 MCP 客户端

🚀 API 端点

供希望直接集成的开发者使用：

HTTP POST /mcp

用于直接集成的标准 MCP JSON-RPC 端点。

Server-Sent Events /sse

用于实时通信的 MCP SSE 传输端点。

Info /

服务信息和状态端点。

直接调用 API 的示例：

curl -X POST https://youtube-transcript-mcp.ergut.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_transcript",
      "arguments": {
        "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "language": "en"
      }
    }
  }'

🐛 故障排除

常见问题

1. Claude Desktop 中出现 "Connection Error"

   • 确保使用的是最新版本的 Claude Desktop
   • 检查 mcp-remote 是否已正确配置
   • 尝试添加 --debug 标志以查看详细日志

2. "Could not attach to MCP server"

   • 检查互联网连接
   • 检查服务 URL 是否正确
   • 更改配置后重启 Claude Desktop

3. 未返回转录文本

   • 确认 YouTube URL 有效且可访问
   • 检查视频是否已启用字幕
   • 如果有其他语言代码，请尝试使用

获取帮助

• 检查日志：在 ~/.mcp-auth/ 中查找调试日志
• 测试直接连接：使用 npx -p mcp-remote@latest mcp-remote-client https://youtube-transcript-mcp.ergut.workers.dev/sse
• 验证服务状态：访问 https://youtube-transcript-mcp.ergut.workers.dev/
• 提交问题：GitHub Issues

🤝 参与贡献

这是一个开源项目，欢迎贡献！

• 报告问题：发现了 Bug？请提交问题
• 功能请求：有改进建议？请告诉我们！
• 代码贡献：欢迎提交改进相关的 PR

开发环境设置

git clone https://github.com/ergut/youtube-transcript-mcp
cd youtube-transcript-mcp
npm install
npm run dev

📜 许可证

本项目为开源项目，采用 MIT License。

🙏 致谢

• 使用 Anthropic 提供的 Model Context Protocol 构建
• 托管于 Cloudflare Workers
• 使用 youtube-transcript 库
• 灵感来自 MCP 社区和现有的本地转录文本服务

---

准备好让 Claude 轻松提取 YouTube 转录文本了吗？ 将此服务添加到 Claude Desktop 配置中，即可立即开始提取任何 YouTube 视频的转录文本！🎉