AI导哈

YouTube字幕处理服务

一个用于提取、搜索和分析YouTube视频字幕的MCP服务器，适用于Claude Desktop、Cursor等MCP兼容客户端。

  • by alex2zimmermann-ux
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 alex2zimmermann-ux/yt-transcript-mcp

使用说明

YouTube转录MCP服务器

提取、搜索和分析YouTube视频转录的MCP（模型上下文协议）服务器。适用于Claude Desktop、Cursor和任何兼容MCP的客户端。

特性

  • 获取成绩单 -从任何YouTube视频中提取完整文字记录
  • 搜索成绩单 -查找具有周围上下文的特定关键字
  • 成绩单摘要 -获取分时间段的成绩单，以便于分析
  • 批处理 -一次最多处理10个视频

安装

pip（推荐）

pip install yt-transcript-mcp

来源

git clone https://github.com/alex2zimmermann-ux/yt-transcript-mcp
cd yt-transcript-mcp
pip install .

配置

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "yt-transcript-mcp",
      "env": {
        "YT_MCP_MODE": "standalone"
      }
    }
  }
}

环境变量

变量 默认值 描述
YT_MCP_MODE standalone standalone 或 backend
YT_MCP_BACKEND_URL http://localhost:8300 后端服务URL
YT_MCP_BACKEND_API_KEY - 后端的API密钥
YT_MCP_CACHE_MAX_SIZE 100 最大缓存条目数
YT_MCP_CACHE_TTL_SECONDS 3600 缓存TTL（秒）
YT_MCP_RATE_LIMIT_PER_MINUTE 30 费率限制
YT_MCP_TRANSPORT stdio stdio 或 streamable-http

模式

独立（默认）

用途 youtube-transcript-api 直接。轻量级，无外部依赖。最适合市场部署。

后端

连接到支持Cookie、yt-dlp和Whisper回退的正在运行的转录服务（FastAPI）。最适合高级/自托管使用。

工具

get_transcript

获取YouTube视频的文字记录。

参数：

  • url （必填）-YouTube URL或视频ID
  • language （可选，默认：“en”）-语言代码
  • format （可选，默认：“text”）-“text”、“segments”或“both”

search_transcript

在视频转录中搜索关键字。

参数：

  • url （必填）-YouTube URL或视频ID
  • query （必填）-搜索词
  • language （可选，默认值：“en”）
  • context_segments （可选，默认值：1）-要包含的周围分段

get_transcript_summary

按时间块获取成绩单以供分析。

参数：

  • url （必填）-YouTube URL或视频ID
  • language （可选，默认值：“en”）
  • chunk_minutes （可选，默认值：5）

batch_transcripts

同时处理多个视频。

参数：

  • urls （必填）-YouTube网址或ID列表（最多10个）
  • language （可选，默认值：“en”）

码头工人

# Standalone
docker compose --profile standalone up

# Backend
YT_MCP_BACKEND_API_KEY=your-key docker compose --profile backend up

发展

python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest tests/ -v --cov

许可证

麻省理工学院

相关 MCP