Transcriptor MCP

動画を受け取る各ツールでは、url を指定できます。これは対応プラットフォームへのリンク、またはYouTube IDです。各ツールは content（チャット用のテキスト）と structuredContent（コード用の型付きJSON）を返します。

get_transcript

タイムスタンプ、HTML、話者名を含まない、整形済みのプレーンテキストです。lang を指定しない場合、ツールは動画の元の言語のトラックを返します。YouTube以外の多くのプラットフォームでは、動画の言語が示されません。ツールがどのトラックかを判断できない場合は、トラックの一覧を返すため、type と lang を指定して再度呼び出します。入力項目は get_raw_subtitles と同じです。

レスポンス：videoId、url（サーバーが解決した動画ページ）、type、lang、text、is_truncated、total_length、start_offset、end_offset。さらにテキストがある場合、レスポンスには next_cursor も含まれます。

get_raw_subtitles

分割された、SRTまたはVTT形式の生のコンテンツです。

入力：

• type — official または auto。lang を指定しない場合、ツールはこのタイプのトラックを選択します
• lang — 言語コードまたはトラック名。get_available_subtitles に表示されるものを指定します。指定しない場合は、get_transcript と同様に動画の元の言語が選択されます
• response_limit — デフォルトは 50000、最小値は 1000、最大値は 200000 です
• next_cursor — 前回のレスポンスのカーソル

レスポンス：get_transcript の各フィールドに加え、format（srt または vtt）と content が含まれます。

get_available_subtitles

レスポンス：official と auto。各フィールドには、ソート済みの言語コード一覧が含まれます。このツールを最初に使用し、その後、上記のツールに type と lang を指定してください。

get_video_info

yt-dlpから取得した拡張メタデータです。

• 識別情報 — videoId、title、description、webpageUrl
• 投稿者 — uploader、uploaderId、channel、channelId、channelUrl
• 数値 — duration、uploadDate、viewCount、likeCount、commentCount
• 分類情報 — tags、categories、liveStatus、isLive、wasLive、availability
• 画像 — thumbnail、thumbnails

get_video_chapters

レスポンス：chapters。各項目には startTime、endTime、title が含まれます。動画にチャプターがない場合、リストは空です。

get_video_frame

入力：

• timecode — "MM:SS" または "HH:MM:SS.mmm"
• seconds — timecode の代わりに指定します。どちらか一方を指定し、両方は指定しないでください
• format — jpeg（デフォルト）または png
• width — デフォルトは 1280、最大値は 1920 です。ソースより大きい値は指定できません
• quality — 2～31。jpeg形式のみ

レスポンス：画像ブロックに加え、url、timestampSeconds、timestamp、mimeType、sizeBytes、width が含まれます。このツールには ffmpeg が必要です。Dockerイメージには同梱されています。

get_playlist_transcripts

入力：

• url — プレイリストURL、または list= を含む視聴URL
• type、lang、format — get_raw_subtitles と同じですが、lang は必須です。元の言語が選択されるのは、一度に1本の動画のみです
• playlistItems — 1:5、1,3,7、-1 などのyt-dlpの -I 値
• maxItems — 動画の最大数

レスポンス：results。各項目には videoId と text が含まれます。

トランスポート。 サーバーが受け付けるのは POST /mcp のみです。GET と DELETE は 405 を返します。サーバーはステートレスで、Mcp-Session-Id を送信しません。

Node プロセスはベアラートークンをチェックしません。認証と TLS のために、リバースプロキシまたはゲートウェイを前段に配置してください。ホスト型エンドポイントも同じ方式で動作します。

REST API。 もう 1 つのイメージで、同じ抽出機能をプレーン HTTP 経由で利用できます。

docker run --rm -p 3000:3000 artsamsonov/transcriptor-mcp-api:latest

Swagger インターフェースは http://localhost:3000/docs にあります。API と MCP サーバーを含む完全なスタックについては、docker-compose.example.yml をお読みください。

開発。

npm ci
npm run build
npm run start:mcp        # stdio
npm run start:mcp:http   # Streamable HTTP on port 4200
npm test

Node.js 22 以降（20 も引き続き動作しますが、2026 年 4 月にサポートが終了しました）と、PATH に設定された yt-dlp が必要です。フレームのキャプチャには ffmpeg が、WHISPER_MAX_DURATION_SECONDS には ffprobe が必要です（どちらも同じパッケージと Docker イメージに含まれています）。その他のスクリプト：lint、type-check、format、test:coverage、test:e2e:api、test:e2e:mcp。

リリース。 リリースはメンテナーが作成します。手順は .claude/skills/release/SKILL.md に記載されています。バージョンは実行時に package.json から src/version.ts を通じて取得されます。v* タグをプッシュすると、CI が両方のイメージをビルドし、server.json から MCP Registry のエントリーを公開します。

構成。 src/mcp.ts（stdio エントリーポイント）、src/mcp-http.ts（Streamable HTTP）、src/mcp-core.ts（ツール、プロンプト、ウィジェット）、src/youtube.ts（yt-dlp）、src/whisper.ts、src/cache.ts、src/index.ts（REST API）、load/（k6）、src/e2e/（Docker スモークテスト）。