mcp-youtube-トランスクリプト

MCP YouTubeトランスクリプトサーバー

YouTube動画からトランスクリプトを取得できるモデルコンテキストプロトコルサーバーです。シンプルなインターフェースから動画のトランスクリプトに直接アクセスできるため、コンテンツの分析や処理に最適です。

特徴

✨ 主な機能:

YouTube動画からトランスクリプトを抽出する
複数の言語をサポート
連続モードまたは段落モードでテキストをフォーマットする
ビデオのタイトルとメタデータを取得する
自動段落分割
テキストの正規化とHTMLエンティティのデコード
堅牢なエラー処理
タイムスタンプと重複検出

はじめる

前提条件

Node.js 18以上

インストール

インストール方法は 2 つあります。

オプション 1: 手動構成 (本番環境に推奨)

Claude Desktop 構成ファイルを作成または編集します。
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
次の構成を追加します。

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "-y",
        "@sinco-lab/mcp-youtube-transcript"
      ]
    }
  }
}

macOS のクイックセットアップスクリプト:

# Create directory if it doesn't exist
mkdir -p ~/Library/Application\ Support/Claude

# Create or update config file
cat > ~/Library/Application\ Support/Claude/claude_desktop_config.json << 'EOL'
{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "-y",
        "@sinco-lab/mcp-youtube-transcript"
      ]
    }
  }
}
EOL

オプション 2: Smithery 経由 (開発のみ)

npx -y @smithery/cli install @sinco-lab/mcp-youtube-transcript --client claude

⚠️注意: この方法は Smithery のプロキシサービスに依存しているため、本番環境での使用に��推奨されません。

使用法

基本構成

Claude Desktop / Cursor / cline で使用するには、構成が一致していることを確認してください。

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": ["-y", "@sinco-lab/mcp-youtube-transcript"]
    }
  }
}

テスト

クロード・アプ氏と

インストール後にClaudeアプリを再起動します
簡単なコマンドでテストします。
https://www.youtube.com/watch?v=AJpK3YTTKZ4 Summarize this video

出力例:

MCPインスペクターを使用

# Clone and setup
git clone https://github.com/sinco-lab/mcp-youtube-transcript.git
cd mcp-youtube-transcript
npm install
npm run build

# Launch inspector
npx @modelcontextprotocol/inspector node "dist/index.js"

# Access http://localhost:6274 and try these commands:
# 1. List Tools: clink `List Tools`
# 2. Test get_transcripts with:
#    url: "https://www.youtube.com/watch?v=AJpK3YTTKZ4"
#    lang: "en" (optional)
#    enableParagraphs: false (optional)

トラブルシューティングとメンテナンス

クロードログの確認

Claude のログを監視するには、次のコマンドを使用できます。

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

これにより、ログファイルの最後の 20 行が表示され、新しいエントリが追加されるたびに表示され続けます。

注：ClaudeアプリはMCPサーバーのログファイルに自動的にmcp-server-プレフィックスを付けます。例えば、サーバーのログはmcp-server-youtube-transcript.logに書き込まれます。

`npx`キャッシュのクリーニング

npxキャッシュに関連する問題が発生した場合は、次のコマンドを使用して手動でクリーンアップできます。

rm -rf ~/.npm/_npx

これにより、キャッシュされたパッケージが削除され、新しく開始できるようになります。

APIリファレンス

トランスクリプトを取得する

YouTube 動画からトランスクリプトを取得します。

パラメータ:

url (文字列、必須): YouTube 動画の URL または ID
lang (文字列、オプション): 言語コード (デフォルト: "en")
enableParagraphs （ブール値、オプション）：段落モードを有効にする（デフォルト：false）

応答形式:

{
  "content": [{
    "type": "text",
    "text": "Video title and transcript content",
    "metadata": {
      "videoId": "video_id",
      "title": "video_title",
      "language": "transcript_language",
      "timestamp": "processing_time",
      "charCount": "character_count",
      "transcriptCount": "number_of_transcripts",
      "totalDuration": "total_duration",
      "paragraphsEnabled": "paragraph_mode_status"
    }
  }]
}

発達

プロジェクト構造

├── src/
│ ├── index.ts            # Server entry point
│ ├── youtube.ts          # YouTube transcript fetching logic
├── dist/                 # Compiled output
└── package.json

主要コンポーネント

YouTubeTranscriptFetcher : コアトランスクリプト取得機能
YouTubeUtils : テキスト処理とユーティリティ

機能と性能

エラー処理:
- 無効なURL/ID
- 利用できないトランスクリプト
- 言語の可用性
- ネットワークエラー
- レート制限
テキスト処理:
- HTMLエンティティのデコード
- 句読点の正規化
- 空間正規化
- スマートな段落検出

貢献

貢献を歓迎します！問題やプルリクエストをお気軽にご提出ください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

mcp-youtube-transcript