Yt Transcript MCP Cd173366

MCP音视频

提供方 fucurry00

音视频 未标注 Token 社区 / 第三方 Claude DesktopClaude

一个通过YouTube视频URL自动获取字幕的服务器,支持手动和自动生成字幕,输出为Markdown格式,适用于内容分析和摘要生成。

一句话选型结论

按资料字段整理

Yt Transcript MCP Cd173366 属于音视频类 MCP 服务器,传输方式未标注,Token,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类音视频 传输方式未标注 鉴权Token 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 1 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

音视频
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量1暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

字幕提取Python本地部署YouTube工具内容分析多语言支持Markdown输出

安装与配置

未标注 Token
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 1 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
转写与字幕

把音视频转成文字和字幕。

音视频处理

裁剪、转码、拼接素材。

内容分发

把成品发到对应平台。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 1 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在音视频场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Yt Transcript MCP Cd173366当前 1 未标注 未标注 无 2026-05-17
Ableton MCP B7b69a6a 16 stdio · 本地进程 本地部署 有 2026-05-17
Mini Max MCP 8 SSE · 服务端推送 远程部署 有 2026-05-18
LocalAI 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Youtube E0eb3510 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Voicemode MCP 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

音视频
字段来自项目仓库与公开索引,中文说明由本站标注
提供方fucurry00上游标注的维护方 fucurry00
分类音视频本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.2 KB
来自项目仓库与上游目录的原文,未做删改

YouTube Transcript MCP Server

> [!NOTE]
> このプロジェクトは初学者によりバイブコーディングされています。

YouTube の URL または動画 ID から、字幕・メタデータを取得する MCP サーバーです。
Claude Desktop / OpenAI Codex などから、動画の要約、翻訳、ノート化、内容確認に使えます。

主な機能

  • YouTube URL / 11 文字の動画 ID に対応
  • 手動字幕を優先し、なければ自動生成字幕にフォールバック
  • 字幕言語は ja / en / ko を優先(自動選択)、タイムスタンプ付与は任意指定
  • Markdown 形式で字幕を出力
  • タイトル、投稿者、投稿日などのメタデータも取得
  • ローカルキャッシュに対応(stdio 接続)

提供ツール

ツール 用途
youtube_get_transcript 字幕を取得し、Markdown 形式で返す
youtube_get_video_info 動画メタデータのみを JSON で返す
youtube_get_frame 指定時刻のフレームを 1 枚、画像で返す

セットアップ

前提

  • Python 3.10 以上
  • uv が利用できること

インストール```bash

cd yt-transcript-mcp
uv sync


これだけで `yt-dlp` を含む依存が揃います。システムに `yt-dlp` を別途インストールする必要はありません(`uv run` 配下では venv 内の `yt-dlp` が PATH 上のものより優先されます)。

> [!IMPORTANT]
> `yt-dlp` は YouTube 側の仕様変更に追従し続けることで動いているツールです。`uv.lock` に固定したまま放置するといずれメタデータ取得が壊れます。壊れたら(あるいは定期的に)次を実行してください。
>
>```bash
> uv lock --upgrade-package yt-dlp && uv sync
> ```

## クライアント設定

### Claude Desktop

`~/.claude/claude_desktop_config.json` に追加します。```json
{
  "mcpServers": {
    "yt-transcript-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/yt-transcript-mcp",
        "python",
        "server.py"
      ]
    }
  }
}

OpenAI Codex

~/.codex/config.toml に追加します。```toml
[mcp_servers.yt-transcript-mcp]
command = "uv"
args = ["run", "--directory", "/path/to/yt-transcript-mcp", "python", "server.py"]


## 使い方

MCP クライアントで YouTube URL を含む依頼をします。```text
この動画を要約して: https://www.youtube.com/watch?v=xxxxx

youtube_get_transcript

パラメータ デフォルト 説明
url 必須 YouTube URL または 11 文字の動画 ID
include_timestamps false true にすると各行に [MM:SS] を付ける

字幕言語は ja / en / ko の順で自動選択し、見つからない場合は利用可能な字幕にフォールバックします。メタデータ(タイトル・投稿者など)は常に付与されます。

タイムスタンプは、インライン出力ではデフォルト OFF(include_timestamps=true で ON)ですが、書き出される .md ファイルは常に [MM:SS] 付きです。

出力例:```markdown

動画タイトル

  • Author: チャンネル名
  • URL: https://www.youtube.com/watch?v=xxxxx
  • Video ID: xxxxx
  • Transcript language: ja
  • Transcript source: auto-generated
  • Upload date: 2025-01-15
  • Duration: 12m30s
  • Transcript file: /abs/path/.transcript_cache/xxxxx.md

Chapters

  • [00:00] イントロ
  • [01:07] 本編

Transcript

こんにちは、今日は...


`## Chapters` は動画にチャプターが設定されているときだけ出ます。

`Transcript file` はタイムスタンプ付き全文(`[MM:SS] テキスト`)を書き出した `.md` の絶対パスです。stdio 接続でクライアントとサーバーが同一マシンにいる前提で、続きの確認・特定語の検索・区間の抜き出しは、このファイルに対してクライアント側の `Read` / `Grep` を使えば専用ツールなしで完結します(`Grep` の結果に `[MM:SS]` が含まれるので、そのまま `youtube_get_frame` の `timestamp` に渡せます)。

非常に長い動画(文字起こしが約 200,000 文字を超える場合)は、先頭約 200,000 文字までで打ち切られ、末尾に注記が付きます。全文は上記 `.md` にあるので、続きはそのファイルを `Read` させます。

### `youtube_get_frame`

字幕だけでは分からない場面(スライド、画面上のコード、図表、字幕なしのデモ)で使います。

| パラメータ | デフォルト | 説明 |
| --- | --- | --- |
| `url` | 必須 | YouTube URL または 11 文字の動画 ID |
| `timestamp` | 必須 | 秒(`90`)、`MM:SS`(`01:30`)、`HH:MM:SS`(`00:01:30`) |

`youtube_get_transcript` に `include_timestamps=true` を渡すと各行に `[MM:SS]` が付くので、
その値をそのまま `timestamp` に渡せます。

動画全体はダウンロードしません。`yt-dlp` でストリーム URL を解決し、`ffmpeg` が HTTP range で
必要な範囲だけ読んで 1 フレームを JPEG で取得します。1 枚あたり約 7〜12 秒かかり、その大半は
`yt-dlp` による URL 解決です(11 分の動画で 12 回計測)。
解像度は 720p 上限です(360p では画面上のコードが判読できず、720p なら本用途には十分なため)。

ストリーム URL は `yt-dlp` の `web_embedded` クライアントで解決します。標準のクライアント
(ANDROID_VR)の URL は、範囲を区切らない HTTP リクエストを 403 で拒否し、`ffmpeg` がそれを送るためです。
`web_embedded` で取れなければ `tv_simply` で解決し直します。ただし `tv_simply` は 360p しかありません。
発行直後の URL は 1 秒ほど 403 を返すことがあるため、403 のときは同じ URL を 1 秒おきに最大 3 回試します。

取得した JPEG は `.transcript_cache/{video_id}_frame_{timestamp}.jpg` に保存し、画像とあわせて
その絶対パス(`Frame saved to: ...`)を返します。同じ地点の再取得はディスクから返るので、
コストの高い `yt-dlp` 解決 + `ffmpeg` デコードをスキップします。パスがあるので、クライアント側で
アセットとしてコピー・埋め込み・参照もできます。

> [!NOTE]
> 画像はクライアント UI 上では折りたたまれて表示さることがありますが、モデルには渡っています。

### `youtube_get_video_info`

動画の概要だけ確認したい場合に使います。```json
{
  "video_id": "xxxxx",
  "title": "動画タイトル",
  "author": "チャンネル名",
  "channel_url": "https://www.youtube.com/...",
  "upload_date": "20250115",
  "duration_seconds": 750,
  "description": "動画の説明文...",
  "chapters": [{ "start_time": 0, "end_time": 67, "title": "イントロ" }],
  "view_count": 12345
}

chapters はチャプター未設定の動画では [] です。start_time は秒なので、youtube_get_frame
の timestamp にそのまま渡せます。

yt-dlp が使えない場合や取得に失敗した場合は、metadata_error に理由が入ります。

キャッシュ

トランスクリプトとフレームはローカルにキャッシュされます。

  • デフォルト保存先: yt-transcript-mcp/.transcript_cache/
  • {video_id}_{langs}.json: 生の字幕エントリ(TTL 180 日)
  • {video_id}.md: タイムスタンプ付き全文(Read/Grep 用)
  • {video_id}_frame_{timestamp}.jpg: 取得済みフレーム
  • 有効期間: 180 日(.json のみ判定。.md / .jpg は上書き・再生成されます)
  • 保存先変更: CACHE_DIR=/path/to/cache

例:```bash
CACHE_DIR=/tmp/yt-transcript-cache uv run python server.py


## トラブルシューティング

### 字幕が取れない

- 動画に字幕がない可能性があります
- 字幕言語は `ja` / `en` / `ko` を優先し、なければ利用可能な字幕に自動フォールバックします
- プライベート動画、年齢制限動画、地域制限動画は取得できない場合があります

### メタデータが `Unknown` になる

- `youtube_get_video_info` の JSON に `metadata_error` がある場合は、`type` と `stderr` を確認してください
- `type` が `yt_dlp_not_found` なら依存が入っていません。`uv sync` を実行してください
- それ以外(`yt_dlp_failed` など)で `stderr` が YouTube の仕様変更を示している場合は、`yt-dlp` が古い可能性があります。`uv lock --upgrade-package yt-dlp && uv sync` で更新してください
- YouTube 側の制限や一時的な取得失敗でも `Unknown` になることがあります

### フレームが取れない

- エラーに `Requested format is not available` とある場合は、`yt-dlp` が JavaScript チャレンジを解けていません。`uv sync` を実行し、`yt-dlp-ejs` と deno が venv に入っているか確認してください
- `403 Forbidden` が再試行後も続く場合は、YouTube 側の仕様変更の可能性があります。`uv lock --upgrade-package yt-dlp && uv sync` で更新してください

### 出力が長すぎる

- インラインの出力は約 200,000 文字までに抑えられ、超過分は先頭で打ち切られます(末尾に注記が付きます)
- ただし全文は `Transcript file` の `.md` に書き出されているので、後半は打ち切りとは関係なくそのファイルを `Read`/`Grep` で参照できます

## 開発```bash
uv sync --dev
uv run python -m unittest discover -s tests
uv run ruff format . && uv run ruff check --fix . && uv run mypy .
コマンド 内容
uv run python -m unittest discover -s tests テストを実行
uv run ruff format . Ruff でフォーマット
uv run ruff check --fix . Ruff の lint を --fix 付きで実行
uv run mypy . mypy を実行
uv lock --upgrade-package yt-dlp && uv sync yt-dlp を最新に更新して lock を書き換える

依存の方針

すべて uv に一本化し、システムへの別途インストールを前提にしない。 他者の環境へ移したときに「私の環境では動く」を起こさないための方針です。

  • youtube-transcript-api — 純粋な Python 依存。uv.lock で固定。
  • yt-dlp — 必須依存。システム版(brew など)があってもそちらは使いません。ただし YouTube の変更に追従し続けることで動くツールなので、固定しっぱなしにしないことが重要です(uv lock --upgrade-package yt-dlp && uv sync)。ここだけは「固定=安全」が成り立ちません。yt-dlp[default,deno] と指定しているため、JavaScript チャレンジを解くスクリプト yt-dlp-ejs と、それを実行する deno(Deno 公式が PyPI で配布するバイナリ)も入ります。どちらもフレーム取得に必要です。yt-dlp は yt-dlp-ejs の版を完全一致で指定しているので、名前で直接指定せず [default] 経由で入れています。[default] からは brotli、certifi、mutagen、pycryptodomex、requests、urllib3、websockets も入ります。
  • imageio-ffmpeg — youtube_get_frame のフレーム抽出に使用。静的バイナリを同梱しており、brew なしで uv 管理下に置けます。ffmpeg 単体のみで ffprobe は付きませんが、フレーム抽出は ffmpeg だけで完結するため問題ありません。

ツール description は短く保つ

MCP クライアントはツール発見時に description と引数スキーマをそのまま会話コンテキストへ流し込みます。
説明が長いほど有効コンテキストを圧迫するため、@mcp.tool(description=...) には「何を返すか」と「引数の意味」だけを書き、
仕様の詳細(出力例、打ち切り、フォールバック順など)はこの README 側に置いてください。

今後の拡張案

  • [ ] 字幕がない動画向けの Whisper 連携
  • [ ] プレイリスト URL の一括処理
  • [ ] キャッシュの明示的な削除・更新オプション

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Yt Transcript MCP Cd173366 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Yt Transcript MCP Cd173366 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Yt Transcript MCP Cd173366 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Yt Transcript MCP Cd173366 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Yt Transcript MCP Cd173366 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Yt Transcript MCP Cd173366 能提供哪些能力?

资料显示约 1 个工具;能力标签包括 内容分析、Python、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。