Youtube Transcript Mcp

YouTube Transcript MCP サーバー

YouTubeTranscript.dev 用の MCP サーバー — 字幕の抽出、履歴の管理、YouTube コンテンツを活用した AI アシスタントの強化ができます。

ウェブサイト • ホスト型 MCP • API ドキュメント • 料金 • クイックスタート • ツール

---

この MCP サーバーを使う理由

カスタムコードなしで、Claude、Cursor、Windsurf、または任意の MCP クライアントを YouTubeTranscript.dev に接続できます。AI アシスタントで、字幕の抽出、履歴の一覧表示、大規模なコンテンツ管理に使えるツールを利用できます。

• ⚡ 高速な字幕抽出 — 手動字幕または自動字幕に対応し、数秒で結果を返します
• 📚 字幕の履歴 — 字幕の一覧表示、検索、ページネーションができます
• 🎯 すべてを管理 — 統計情報の取得、字幕の削除、動画 ID による取得ができます
• 🔌 設定は 1 つだけ — Claude、Cursor、Windsurf、VS Code、Cline で動作します
• 🔒 ユーザー所有のキー — 接続ごとに API キーを使うため、サーバー側にシークレットはありません

→ 無料の API キーを取得

---

クイックスタート

リモート MCP URL：https://mcp.youtubetranscript.dev

Claude、Cursor、VS Code では、リモート MCP コネクターとして追加できます。ChatGPT ユーザーは、Developer mode を有効にして、この URL を使ったカスタムアプリを作成する必要があります。利用できるかどうかはワークスペースのプランによって異なります。OAuth 対応クライアントでは一度サインインすればよいため、チャット内で API キーは必要ありません。

クライアント	ワンクリック
Claude	カスタムコネクターを追加
ChatGPT	Developer mode／カスタム MCP アプリの設定 または Custom GPT
Cursor	インストール
VS Code	インストール
Claude Code	claude mcp add --transport http youtubetranscript https://mcp.youtubetranscript.dev
Grok	grok mcp add --transport http youtubetranscript https://mcp.youtubetranscript.dev

詳しい手順：youtubetranscript.dev/resources/mcp-server

API キーを使うクライアント（ツールが OAuth に対応していない場合）：Authorization: Bearer YOUR_API_KEY を送信します。x-api-token も引き続き使用できます。アカウントページからキーを取得してください。

ローカルで実行（任意）： npm install && npm run build && npm run start:http を実行し、http://localhost:8080 に接続します。

---

MCP 接続設定

Claude Code

claude mcp add --transport http youtubetranscript https://mcp.youtubetranscript.dev

Claude Desktop

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "youtubetranscript": {
      "url": "https://mcp.youtubetranscript.dev",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Cursor

.cursor/mcp.json：

{
  "mcpServers": {
    "youtubetranscript": {
      "url": "https://mcp.youtubetranscript.dev",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "youtubetranscript": {
      "serverUrl": "https://mcp.youtubetranscript.dev",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code + Copilot

settings.json：

{
  "mcp": {
    "servers": {
      "youtubetranscript": {
        "url": "https://mcp.youtubetranscript.dev",
        "headers": { "Authorization": "Bearer YOUR_API_KEY" }
      }
    }
  }
}

Cline

Cline の MCP 設定に追加します（形式は Cline のバージョンによって異なる場合があります）：

{
  "youtubetranscript": {
    "url": "https://mcp.youtubetranscript.dev",
    "headers": { "Authorization": "Bearer YOUR_API_KEY" }
  }
}

---

YOUR_API_KEY を、youtubetranscript.dev/dashboard/accountで取得した API キーに置き換えてください。

---

設定

サーバー環境（デプロイ用）

変数	説明	デフォルト
YTSM_BASE_URL	API のベース URL	https://www.youtubetranscript.dev
MCP_PUBLIC_URL	公開 MCP オリジン	https://mcp.youtubetranscript.dev
YTSM_TIMEOUT_MS	リクエストのタイムアウト（ミリ秒）	30000
PORT	HTTP サーバーのポート	8080
DEBUG	デバッグログを有効にする	false（有効にするには true を設定）

注： HTTP モードでは、対応するクライアント（互換性のある Claude、Cursor、VS Code、Grok クライアントなど）で OAuth を使用します。ChatGPT では Developer mode とカスタム MCP アプリが必要です。API キーを使うクライアントでは、クライアントから Authorization: Bearer／x-api-token を送信できます。ユーザーのキーをサーバー環境変数に設定しないでください。stdio モードでは、YTSM_API_KEY を設定します。必ず YTSM_BASE_URL に https://www.youtubetranscript.dev を設定してください。apex ホストは 301 リダイレクトを返すため、POST／認証で問題が発生します。

---

ツールリファレンス

ツール	最適な用途	返される内容
get_stats	クレジット、文字起こし数、プラン	credits、transcripts_total、plan、rate_limit
transcribe_v2	文字起こしの作成／取得（高速）	文字起こし JSON
list_transcripts	ユーザーの文字起こし一覧	ページネーション付きの履歴一覧
get_transcript	video_id による全文字起こしの取得	文字起こしの詳細
delete_transcript	文字起こしの削除	削除結果

get_stats

残りのクレジット、作成した文字起こし数、プラン、レート制限を取得します。パラメーターはありません。

transcribe_v2

キャプションを使用した高速な文字起こし（ASR なし）です。手動または自動のキャプションのみを使用します。

パラメーター	必須	説明
video	はい	YouTube URL または 11 文字の動画 ID
language	いいえ	言語タグ（例：en、en-US）
source	いいえ	auto（デフォルト）または manual
format	いいえ	{ timestamp, paragraphs, words } のブール値

list_transcripts

認証済みユーザーの文字起こし履歴を一覧表示します。

パラメーター	必須	説明
search	いいえ	動画 ID、タイトル、または文字起こしテキストで検索
limit	いいえ	返す件数（デフォルトは 10）
page	いいえ	ページ番号（デフォルトは 1）
status	いいえ	all、queued、processing、succeeded、failed
language	いいえ	言語フィルター（例：en）
include_segments	いいえ	レスポンスに文字起こしのセグメントを含める

get_transcript

video_id によって全文字起こしを取得します。

パラメーター	必須	説明
video_id	はい	YouTube 動画 ID
id	いいえ	特定のバージョンの文字起こしレコード ID
language	いいえ	言語フィルター
source	いいえ	auto、manual、または asr
include_timestamps	いいえ	レスポンスにタイムスタンプを含める

delete_transcript

文字起こしレコードを削除します。

パラメーター	必須	説明
ids	いいえ*	削除する文字起こしレコード ID の配列
video_id	いいえ*	便利な方法：動画 ID で削除（ID を解決します）

*ids または video_id の少なくとも一方を指定してください。

---

デプロイ（任意）

本番環境では、長時間接続をサポートするサービス（例：Cloud Run、Railway、Fly.io）にデプロイしてください。MCP ではサーバーレス（Vercel、Lambda）を避けてください。タイムアウトや同時実行数の制限によって問題が発生します。

docker build -f Dockerfile.cloudrun -t gcr.io/YOUR_PROJECT/youtube-transcript-mcp .
docker push gcr.io/YOUR_PROJECT/youtube-transcript-mcp
gcloud run deploy youtube-transcript-mcp --image gcr.io/YOUR_PROJECT/youtube-transcript-mcp ...

---

Stdio（代替方法）

HTTP の代わりにサブプロセスとして実行します。**必須：**環境変数に YTSM_API_KEY を設定してください（stdio では API キーはリクエストごとに渡されません）。

{
  "mcpServers": {
    "youtubetranscript": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": { "YTSM_API_KEY": "YOUR_API_KEY" }
    }
  }
}

npm run build の実行後、プロジェクトディレクトリから実行してください。パッケージをグローバルにインストールした場合は、パッケージ内の dist/index.js へのパスを使用してください。

---

開発

npm install
npm run build
npm test
npm run start:http   # Local HTTP server (port 8080)

すべてのツールを簡単にテストする（環境変数に YTSM_API_KEY が必要です）：

npm install && npm run build
export YTSM_API_KEY=your_key   # bash/mac
$env:YTSM_API_KEY="your_key"   # PowerShell
npm run test:all

テスト手順の詳細については、QUICK_TEST.md を参照してください。

---

Links

• 🌐 YouTubeTranscript.dev
• 🔌 Hosted MCP
• 📖 API Documentation
• 💰 Pricing

---

License

MIT License — see LICENSE for details.