Youtube Summarize

io.github.zlatkoc由 GitHub 账号 zlatkoc 发布v0.6.0更新于 Oct 24, 2026

MCP server that fetches YouTube video transcripts and optionally summarizes them

概览

AI 生成的概览

一个本地 MCP 服务器,用于获取 YouTube 视频字幕和元数据,并为助手准备可供总结的字幕内容。

可以做什么
以文本、JSON、SRT、WebVTT 或美化格式获取视频字幕,可选时间戳和元数据块,并列出视频可用的字幕语言。获取视频元数据,如标题、频道、上传日期、时长、观看数、标签和章节。列出公开播放列表中的视频,支持排序和结果数量限制。搜索 YouTube 视频,支持排序、上传时间和时长筛选,返回干净的排序列表。返回字幕并附带按标签分段的总结提示,便于人工审阅。
适用场景
适合让助手在不观看视频的情况下阅读、引用或总结 YouTube 内容,或为研究、内容工作收集视频、播放列表信息和搜索结果。
运行要求
以 Python 包(youtube-summarize)通过 uvx 在本地以 stdio 运行;需要 Python 3.13+ 和 uv 包管理器。需要访问 YouTube 的网络;未声明账号、API 密钥或环境变量。
安装前请注意
它会代你获取公开的 YouTube 数据,请求会发往 YouTube,可能受速率限制或被拦截。总结输出是供助手处理的材料,使用结果前请先审阅提示和字幕。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Youtube Summarize,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

youtube-summarize

MCP server that fetches YouTube video transcripts and optionally summarizes them.

[Demo — summarizing a YouTube video in Claude]

Features

  • Fetch transcripts in multiple formats (text, JSON, SRT, WebVTT, pretty-print)
  • Video metadata — title, description, channel, upload date, duration, views, chapters (via yt-dlp)
  • Optional timestamps in plain-text transcripts
  • Summarize videos — returns transcript with the prompt clearly broken out for human review before the LLM acts on it
  • List playlist videos — fast enumeration of any public playlist with optional sorting
  • Search videos — clean ranked results with sort and filter options, without the ads, Shorts shelves, and personalized recommendations of the YouTube website
  • List available languages for any video's transcripts
  • Flexible URL parsing — accepts full YouTube URLs (youtube.com/watch?v=, youtu.be/, youtube.com/embed/, youtube.com/shorts/) or bare video IDs
  • Multi-language support — request transcripts in specific languages with fallback priority

Tools

get_transcript

Fetch a YouTube video's transcript. By default the response is prefixed with a [METADATA] block (title, channel, published, duration, views, description); pass include_metadata=false for transcript-only output.

ParameterTypeDefaultDescription
urlstringrequiredYouTube video URL or video ID
languagesstring[]["en"]Preferred languages in priority order
formatstring"text"Output format: text, json, pretty, webvtt, srt
preserve_formattingbooleanfalseKeep HTML formatting tags in the transcript
include_timestampsbooleanfalseWhen true with format="text", prefix each line with [HH:MM:SS]. Ignored for other formats (they already include timestamps).
include_metadatabooleantruePrepend a [METADATA] block before the transcript. Pass false for transcript-only output.

summarize_transcript

Fetch a transcript and return it with summarization instructions. The response is structured into clearly-labeled sections ([INSTRUCTIONS], [PROMPT_SOURCE], [VIDEO], [METADATA], [TRANSCRIPT]) so a human can review the prompt before letting the LLM act on it.

ParameterTypeDefaultDescription
urlstringrequiredYouTube video URL or video ID
promptstring(default prompt)Custom summarization instructions
languagesstring[]["en"]Preferred languages in priority order
include_timestampsbooleanfalsePrefix each transcript line with [HH:MM:SS].
include_metadatabooleantrueInclude a [VIDEO] block with title, channel, published, duration, views, and description.

get_video_metadata

Fetch metadata (title, description, channel, upload date, duration, views, tags, chapters, etc.) for a YouTube video. Backed by yt-dlp.

ParameterTypeDefaultDescription
urlstringrequiredYouTube video URL or video ID

list_playlist_videos

List the videos in a YouTube playlist (title, ID, channel, duration, views, URL). Per-video metadata is intentionally lean so the call stays fast even for large playlists; call get_video_metadata with a specific video ID for full detail.

ParameterTypeDefaultDescription
urlstringrequiredYouTube playlist URL (with ?list=...) or bare playlist ID
limitinteger500Maximum videos to return
sort_bystring"index"One of: index (playlist order), title, duration, views. upload_date is not supported.
orderstring"asc"asc or desc

search_videos

Search YouTube for videos and return a clean ranked list (title, ID, channel, duration, views, URL) — only actual videos, with no ads, recommendation shelves, or personalization. Relevance ordering still comes from YouTube's backend. Pair with get_transcript or summarize_transcript on a result's ID or URL.

ParameterTypeDefaultDescription
querystringrequiredSearch terms
limitinteger10Maximum results to return
sort_bystring"relevance"One of: relevance, date (newest first), views, rating
uploadedstring"any"Filter by upload time: any, hour, today, week, month, year
durationstring"any"Filter by length: any, short (<4 min), medium (4–20 min), long (>20 min)

list_transcripts

List available transcript languages for a video.

ParameterTypeDefaultDescription
urlstringrequiredYouTube video URL or video ID

Installation

Quick start (recommended)

bash
uvx youtube-summarize

Claude Desktop

Add to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
json
{  "mcpServers": {    "youtube-summarize": {      "command": "uvx",      "args": ["youtube-summarize"]    }  }}

Claude Code

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

Other MCP clients

Run the server over stdio:

bash
uvx youtube-summarize

Prerequisites

  • Python 3.13+
  • uv package manager

Development

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

License

MIT


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

来源:README.md,提交 3477951

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.6.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分