YouTube MCP サーバー移行記録¶

対応日: 2026-02-22 対応issue: #21 YouTube MCP (mcp-youtube) の429レート制限エラーへの対応

問題の状態（移行前）¶

項目	内容
使用MCPサーバー	`@anaisbetts/mcp-youtube`
内部実装	`yt-dlp` v2026.02.04
エラー内容	`HTTP Error 429: Too Many Requests`
原因	YouTubeがyt-dlpのリクエストをBotとして検出・レート制限
副次問題	Deno未インストール（品質低下）、ffmpeg未インストール

ERROR: Unable to download video subtitles for 'en': HTTP Error 429: Too Many Requests

npx -y youtube-transcript-mcp
# → '"bun"' is not recognized エラー
# → Bunランタイムが必要と判明

irm bun.sh/install.ps1 | iex
# → Bun 1.3.9 インストール完了
# → C:\Users\Kazuma Teramachi\.bun\bin\bun.exe
# → ユーザーPATHに自動登録済み

動作確認:

bun --version
# → 1.3.9

timeout 5 npx -y youtube-transcript-mcp
# → タイムアウト（サーバーが起動して待機中）= 正常動作

~/.claude.json を直接編集（Pythonスクリプトで更新）:

変更前:

"mcp-youtube": {
  "command": "cmd",
  "args": ["/c", "npx", "-y", "@anaisbetts/mcp-youtube"]
}

変更後:

"mcp-youtube": {
  "command": "cmd",
  "args": ["/c", "npx", "-y", "youtube-transcript-mcp"]
}

注意: claude mcp add コマンドはbash上で /c が C:/ に変換されるバグがあったため、Pythonで直接JSON編集を採用。

作業内容をissueコメントとして残した。

項目	内容
使用MCPサーバー	`youtube-transcript-mcp` v0.1.5
内部実装	YouTube字幕API直接利用（yt-dlp不依存）
Bunランタイム	v1.3.9（`~/.bun/bin/`）
設定場所	`~/.claude.json` > `mcpServers` > `mcp-youtube`