youtube-summarize

youtube-summarize

YouTube 動画の文字起こしを取得し、必要に応じて要約する MCP サーバーです。

機能

• 文字起こしの取得 — 複数の形式（テキスト、JSON、SRT、WebVTT、整形済み表示）に対応
• 動画のメタデータ — タイトル、説明、チャンネル、アップロード日、再生時間、再生回数、チャプター（yt-dlp 経由）
• プレーンテキスト形式の文字起こしにタイムスタンプを追加
• 動画の要約 — LLM が処理を始める前に人が確認できるよう、文字起こしとプロンプトを明確に分けて返します
• 再生リスト内の動画の一覧表示 — 公開再生リスト内の動画をすばやく一覧表示し、並べ替えにも対応
• 動画の検索 — YouTube ウェブサイトの広告、Shorts の棚、パーソナライズされたおすすめを除いた、並べ替えとフィルターに対応する見やすいランキング結果
• 動画の文字起こしで利用可能な言語の一覧表示
• 柔軟な URL 解析 — YouTube の完全な URL（youtube.com/watch?v=、youtu.be/、youtube.com/embed/、youtube.com/shorts/）または動画 ID のみを指定できます
• 多言語対応 — 優先順位を指定して、特定の言語で文字起こしを取得できます

ツール

get_transcript

YouTube 動画の文字起こしを取得します。デフォルトでは、応答の先頭に [METADATA] ブロック（タイトル、チャンネル、公開日、再生時間、再生回数、説明）が付加されます。文字起こしのみを出力するには、include_metadata=false を指定してください。

パラメーター	型	デフォルト	説明
url	string	必須	YouTube 動画の URL または動画 ID
languages	string[]	["en"]	優先順位順に指定する言語
format	string	"text"	出力形式：text、json、pretty、webvtt、srt
preserve_formatting	boolean	false	文字起こし内の HTML 書式タグを保持します
include_timestamps	boolean	false	format="text" の場合、各行の先頭に [HH:MM:SS] を付けます。他の形式では無視されます（すでにタイムスタンプを含んでいます）。
include_metadata	boolean	true	文字起こしの前に [METADATA] ブロックを付加します。文字起こしのみを出力するには、false を指定してください。

summarize_transcript

文字起こしを取得し、要約の指示とともに返します。応答は明確にラベル付けされたセクション（[INSTRUCTIONS]、[PROMPT_SOURCE]、[VIDEO]、[METADATA]、[TRANSCRIPT]）で構成されており、LLM に処理させる前に人がプロンプトを確認できます。

パラメーター	型	デフォルト	説明
url	string	必須	YouTube 動画の URL または動画 ID
prompt	string	(デフォルトのプロンプト)	カスタムの要約指示
languages	string[]	["en"]	優先順位順に指定する言語
include_timestamps	boolean	false	文字起こしの各行の先頭に [HH:MM:SS] を付けます。
include_metadata	boolean	true	タイトル、チャンネル、公開日、再生時間、再生回数、説明を含む [VIDEO] ブロックを含めます。

get_video_metadata

YouTube 動画のメタデータ（タイトル、説明、チャンネル、アップロード日、再生時間、再生回数、タグ、チャプターなど）を取得します。yt-dlp を使用しています。

パラメーター	型	デフォルト	説明
url	string	必須	YouTube 動画の URL または動画 ID

list_playlist_videos

YouTube 再生リスト内の動画を一覧表示します（タイトル、ID、チャンネル、再生時間、再生回数、URL）。大規模な再生リストでも呼び出しを高速に保つため、各動画のメタデータは意図的に最小限にしています。詳細な情報を取得するには、特定の動画 ID を指定して get_video_metadata を呼び出してください。

パラメーター	型	デフォルト	説明
url	string	必須	YouTube 再生リストの URL（?list=... を含む）または再生リスト ID のみ
limit	integer	500	返す動画の最大数
sort_by	string	"index"	次のいずれか：index（再生リストの順序）、title、duration、views。upload_date はサポートされていません。
order	string	"asc"	asc または desc

search_videos

YouTube で動画を検索し、タイトル、ID、チャンネル、再生時間、再生回数、URL を含む、整理されたランキング形式のリストを返します。広告、おすすめ動画の棚、パーソナライズされた結果は含まれず、実際の動画のみが対象です。関連度の順序は引き続き YouTube のバックエンドによって決まります。結果の ID または URL を指定して、get_transcript または summarize_transcript と組み合わせてください。

パラメーター	型	デフォルト	説明
query	string	必須	検索語句
limit	integer	10	返す結果の最大数
sort_by	string	"relevance"	次のいずれか：relevance、date（新しい順）、views、rating
uploaded	string	"any"	アップロード時期で絞り込み：any、hour、today、week、month、year
duration	string	"any"	長さで絞り込み：any、short（4 分未満）、medium（4～20 分）、long（20 分超）

list_transcripts

動画で利用可能な字幕の言語を一覧表示します。

パラメーター	型	デフォルト	説明
url	string	必須	YouTube 動画の URL または動画 ID

インストール

クイックスタート（推奨）

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