MCP YouTubeトランスクリプトサーバー
YouTube動画からトランスクリプトを取得できるモデルコンテキストプロトコルサーバーです。シンプルなインターフェースから動画のトランスクリプトに直接アクセスできるため、コンテンツの分析や処理に最適です。
目次
Related MCP server: YouTube Transcript Server
特徴
✨ 主な機能:
YouTube動画からトランスクリプトを抽出する
複数の言語をサポート
連続モードまたは段落モードでテキストをフォーマットする
ビデオのタイトルとメタデータを取得する
自動段落分割
テキストの正規化とHTMLエンティティのデコード
堅牢なエラー処理
タイムスタンプと重複検出
はじめる
前提条件
Node.js 18以上
インストール
インストール方法は 2 つあります。
オプション 1: 手動構成 (本番環境に推奨)
Claude Desktop 構成ファイルを作成または編集します。
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%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 または IDlang(文字列、オプション): 言語コード (デフォルト: "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ファイルを参照してください。