YouTube Transcript Remote MCP Server

Claude AIがYouTube動画から文字起こしを抽出できるようにする、初のリモートModel Context Protocol（MCP）サーバーです。このサーバーは、モバイル端末を含むあらゆるプラットフォームのユーザーに、セットアップ不要のアクセスを提供します。

🌟 特徴

• ローカルセットアップ不要: インストール不要 - クラウドから直接動作

• ユニバーサルアクセス: Claudeのデスクトップ版、モバイル版、Web版で動作

• スマートキャッシング: Cloudflare KVを使用した効率的なキャッシュシステムで高速応答

• 多言語対応: さまざまな言語で文字起こしを取得可能

• エラーハンドリング: ユーザーフレンドリーなメッセージによる堅牢なエラー処理

• アナリティクス: 組み込みのリクエスト追跡と利用状況分析

• URLの柔軟性: すべてのYouTube URL形式（youtube.com、youtu.be、m.youtube.comなど）に対応

Related MCP server: ytt-mcp

🚀 クイックスタート

オプション1: ホスト型サーバーを使用（推奨）

最も簡単な始め方 - 公開サーバーをClaude Desktopに追加するだけです：

Claude Desktopユーザー向け

1. Claude Desktopの設定を開く

   • メニューバーの「Claude」をクリック →「設定」

   • 「開発者」タブに移動

   • 「設定を編集」をクリック

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

• キャッシング: 成功した文字起こしを7日間キャッシュするCloudflare KV

• レート制限: 指数バックオフ付きの組み込みリトライロジック

• 稼働時間: 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トランスポートエンドポイント。

情報 /

サーバー情報とステータスエンドポイント。

直接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ライセンスの下で利用可能です。

🙏 謝辞

• AnthropicによるModel Context Protocolを使用して構築

• Cloudflare Workersでホスト

• youtube-transcriptライブラリを使用

• MCPコミュニティと既存のローカル文字起こしサーバーに触発されました

ClaudeにYouTubeの文字起こし抽出機能を追加する準備はできましたか？ このサーバーをClaude Desktopの設定に追加して、あらゆるYouTube動画から即座に文字起こしを抽出しましょう！🎉