Youtube Transcript Remote MCP Server

🌟 特長

• ローカルでのセットアップ不要：インストールは不要です。クラウドから直接利用できます
• あらゆる環境で利用可能：Claude のデスクトップ版、モバイル版、ウェブ版で利用できます
• スマートキャッシュ：Cloudflare KV を使用した効率的なキャッシュシステムにより、高速に応答します
• 多言語対応：さまざまな言語のトランスクリプトを抽出できます
• エラー処理：ユーザーにわかりやすいメッセージで、堅牢なエラー処理を実現します
• 分析機能：リクエスト追跡と利用状況分析機能を内蔵しています
• URL の柔軟な対応：すべての YouTube URL 形式（youtube.com、youtu.be、m.youtube.com など）に対応します

🚀 クイックスタート

オプション 1：ホスト済みサーバーを使用する（推奨）

最も簡単な方法です。公開サーバーを Claude Desktop に追加するだけで利用できます。

Claude Desktop ユーザー向け

1. Claude Desktop の設定を開く

   • メニューバーの「Claude」→「Settings」をクリックします
   • 「Developer」タブに移動します
   • 「Edit Config」をクリックします

2. MCP サーバーの設定を追加する

   claude_desktop_config.json に以下を追加します。

   {
     "mcpServers": {
       "youtube-transcript": {
         "command": "npx",
         "args": [
           "mcp-remote",
           "https://youtube-transcript-mcp.ergut.workers.dev/sse"
         ]
       }
     }
   }
   

3. Claude Desktop を再起動する

   設定ファイルを保存した後、サーバーを読み込むために Claude Desktop を再起動します。

4. インストールを確認する

   チャット画面にツールアイコン（🔧）が表示されていることを確認します。get_transcript ツールが利用可能になっているはずです。

オプション 2：独自のサーバーをデプロイする

独自のインスタンスを実行しますか？ワンクリックで Cloudflare Workers にデプロイできます。

または、手動でデプロイします。

git clone https://github.com/ergut/youtube-transcript-mcp
cd youtube-transcript-mcp
npm install
npm run deploy

その他の MCP クライアント向け

このサーバーは標準の MCP プロトコルに対応しており、互換性のある任意のクライアントで使用できます。

• 公開サーバー URL：https://youtube-transcript-mcp.ergut.workers.dev/sse
• トランスポート：Server-Sent Events（SSE）または HTTP
• 認証：不要（公開サーバー）

📖 使用例

基本的なトランスクリプトの抽出

Extract the transcript from this YouTube video: https://www.youtube.com/watch?v=dQw4w9WgXcQ

多言語対応

Can you get the transcript of this video in Turkish: https://youtu.be/VIDEO_ID

Extract the Spanish transcript from: https://www.youtube.com/watch?v=VIDEO_ID

対応 URL 形式

このサーバーは、すべての YouTube URL 形式に自動的に対応します。

• https://www.youtube.com/watch?v=VIDEO_ID
• https://youtu.be/VIDEO_ID
• https://m.youtube.com/watch?v=VIDEO_ID
• https://www.youtube.com/live/VIDEO_ID
• https://www.youtube.com/embed/VIDEO_ID
• https://www.youtube.com/shorts/VIDEO_ID
• 各国のドメイン（youtube.co.uk、youtube.de など）

すべてのトラッキングパラメーター（?si=、&t= など）は自動的に削除されます。

🛠 利用可能なツール

get_transcript

YouTube 動画の URL からトランスクリプトを抽出します。

パラメーター：

• url（必須）：任意の形式の YouTube 動画 URL
• language（任意）：トランスクリプトの言語コード（例：'en'、'es'、'fr'）。デフォルトは 'en' です。

使用例：

{
  "name": "get_transcript",
  "arguments": {
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "language": "en"
  }
}

🔧 高度な設定

デバッグログ

トラブルシューティング用に詳細なログを有効にするには、次のようにします。

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://youtube-transcript-mcp.ergut.workers.dev/sse",
        "--debug"
      ]
    }
  }
}

デバッグログは ~/.mcp-auth/{server_hash}_debug.log に作成されます。

HTTP トランスポートのみを使用する

SSE の代わりに HTTP トランスポートを強制するには、次のようにします。

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://youtube-transcript-mcp.ergut.workers.dev/mcp",
        "--transport",
        "http-only"
      ]
    }
  }
}

📊 サーバー情報

• ホスティング：Cloudflare Workers
• キャッシュ：Cloudflare KV。トランスクリプトの取得に成功した場合、7 日間キャッシュします
• レート制限：指数バックオフを用いたリトライロジックを内蔵しています
• 稼働率：Cloudflare のグローバルネットワークにより、99.9% 以上の可用性を実現しています
• 応答時間：キャッシュ済みコンテンツは通常 3 秒未満、新規リクエストは 10 秒未満です

🚨 エラー処理

サーバーは、よくある問題について明確なエラーメッセージを表示します。

• 「無効な YouTube URL が指定されました」：URL の形式が認識されません
• 「この動画のトランスクリプトはありません」：動画に字幕またはトランスクリプトがありません
• 「動画が見つからないか、非公開です」：動画が非公開、削除済み、または存在しません
• 「サービスが一時的に混み合っています。数分後に再試行してください」：YouTube によるレート制限です
• 「この動画ではトランスクリプトが無効になっています」：投稿者が字幕を無効にしています

🌍 言語サポート

サーバーは、YouTube がトランスクリプトを提供しているすべての言語に対応しています。よく使われる言語コードは次のとおりです。

• en - 英語（デフォルト）
• tr - トルコ語
• es - スペイン語
• fr - フランス語
• de - ドイツ語
• it - イタリア語
• pt - ポルトガル語
• ja - 日本語
• ko - 韓国語
• zh - 中国語

🔒 プライバシーとセキュリティ

• 認証不要：使いやすさを重視した公開サーバーです
• データ保存なし：パフォーマンス向上のため、トランスクリプトを一時的にキャッシュするだけです
• 個人情報なし：処理するのは YouTube 動画 ID とトランスクリプトのみです
• HTTPS のみ：すべての通信は暗号化されます
• CORS 有効：Web ベースの MCP クライアントに対応しています

🚀 API エンドポイント

直接統合したい開発者向け：

HTTP POST /mcp

直接統合に使用する標準の MCP JSON-RPC エンドポイントです。

Server-Sent Events /sse

リアルタイム通信に使用する MCP SSE トランスポートエンドポイントです。

Info /

サーバー情報とステータスを確認できるエンドポイントです。

API の直接呼び出し例：

curl -X POST https://youtube-transcript-mcp.ergut.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_transcript",
      "arguments": {
        "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "language": "en"
      }
    }
  }'

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

よくある問題

1. Claude Desktop で「接続エラー」が表示される

   • Claude Desktop が最新バージョンであることを確認してください
   • mcp-remote が正しく設定されていることを確認してください
   • 詳細なログを確認するには、--debug フラグを追加してください

2. 「MCP サーバーに接続できませんでした」と表示される

   • インターネット接続を確認してください
   • サーバー URL が正しいことを確認してください
   • 設定を変更した後、Claude Desktop を再起動してください

3. トランスクリプトが返されない

   • YouTube URL が有効で、アクセス可能であることを確認してください
   • 動画で字幕が有効になっているか確認してください
   • 利用可能であれば、別の言語コードを試してください

ヘルプを受ける

• ログを確認：デバッグログは ~/.mcp-auth/ を確認してください
• 直接接続をテスト：npx -p mcp-remote@latest mcp-remote-client https://youtube-transcript-mcp.ergut.workers.dev/sse を使用してください
• サーバーのステータスを確認：https://youtube-transcript-mcp.ergut.workers.dev/ にアクセスしてください
• 問題を報告：GitHub Issues

🤝 コントリビューション

これはオープンソースプロジェクトです。コントリビューションを歓迎します！

• 問題を報告：バグを見つけましたか？問題を報告してください
• 機能のリクエスト：改善のアイデアがありますか？ぜひお知らせください！
• コードへの貢献：機能強化のための PR を歓迎します

開発環境のセットアップ

git clone https://github.com/ergut/youtube-transcript-mcp
cd youtube-transcript-mcp
npm install
npm run dev

📜 ライセンス

このプロジェクトはオープンソースで、MIT Licenseの下で利用できます。

🙏 謝辞

• Anthropic による Model Context Protocol を使用して構築
• Cloudflare Workers でホスト
• youtube-transcript ライブラリを使用
• MCP コミュニティと既存のローカル トランスクリプトサーバーに着想を得ています

---

YouTube トランスクリプトの抽出で Claude をさらに活用しませんか？ このサーバーを Claude Desktop の設定に追加して、あらゆる YouTube 動画からすぐにトランスクリプトを抽出しましょう！🎉