youtube-summarize

用于获取 YouTube 视频字幕并可选择对其进行总结的 MCP 服务器。

功能

• 获取字幕：支持多种格式（文本、JSON、SRT、WebVTT、美化打印）

• 视频元数据 — 标题、描述、频道、上传日期、时长、观看次数、章节（通过 yt-dlp）

• 可选时间戳：在纯文本字幕中显示

• 总结视频 — 返回字幕，并清晰地列出提示词，以便人类在 LLM 执行前进行审查

• 列出播放列表视频 — 快速枚举任何公开播放列表，并支持可选排序

• 列出可用语言：查看任何视频的可用字幕语言

• 灵活的 URL 解析 — 接受完整的 YouTube URL (youtube.com/watch?v=, youtu.be/, youtube.com/embed/, youtube.com/shorts/) 或纯视频 ID

• 多语言支持 — 按优先级请求特定语言的字幕

Related MCP server: ytt-mcp

工具

get_transcript

获取 YouTube 视频的字幕。默认情况下，响应前会加上一个 [METADATA] 块（标题、频道、发布时间、时长、观看次数、描述）；若只需字幕输出，请设置 include_metadata=false。

summarize_transcript

获取字幕并将其与总结指令一起返回。响应被结构化为清晰标记的部分（[INSTRUCTIONS], [PROMPT_SOURCE], [VIDEO], [METADATA], [TRANSCRIPT]），以便人类在让 LLM 执行前审查提示词。

get_video_metadata

获取 YouTube 视频的元数据（标题、描述、频道、上传日期、时长、观看次数、标签、章节等）。由 yt-dlp 提供支持。

list_playlist_videos

列出 YouTube 播放列表中的视频（标题、ID、频道、时长、观看次数、URL）。每个视频的元数据被刻意精简，以确保即使对于大型播放列表也能保持快速响应；如需完整详情，请使用特定视频 ID 调用 get_video_metadata。

list_transcripts

列出视频可用的字幕语言。

安装

快速开始（推荐）

uvx youtube-summarize

Claude Desktop

添加到你的 claude_desktop_config.json：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "youtube-summarize": {
      "command": "uvx",
      "args": ["youtube-summarize"]
    }
  }
}

Claude Code

claude mcp add youtube-summarize -- uvx youtube-summarize

其他 MCP 客户端

通过 stdio 运行服务器：

uvx youtube-summarize

先决条件

• Python 3.13+

• uv 包管理器

开发

# Install dependencies
uv sync

# Launch the MCP inspector (web UI for testing tools)
uv run mcp dev main.py

许可证

MIT

mcp-name: io.github.zlatkoc/youtube-summarize