Skip to main content
Glama

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

鍛冶屋のバッジ

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

目次

Related MCP server: YouTube Transcript Server

特徴

✨ 主な機能:

  • YouTube動画からトランスクリプトを抽出する

  • 複数の言語をサポート

  • 連続モードまたは段落モードでテキストをフォーマットする

  • ビデオのタイトルとメタデータを取得する

  • 自動段落分割

  • テキストの正規化とHTMLエンティティのデコード

  • 堅牢なエラー処理

  • タイムスタンプと重複検出

はじめる

前提条件

  • Node.js 18以上

インストール

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

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

  1. Claude Desktop 構成ファイルを作成または編集します。

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. 次の構成を追加します。

{ "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"] } } }

テスト

クロード・アプ氏と

  1. インストール後にClaudeアプリを再起動します

  2. 簡単なコマンドでテストします。

    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ファイルを参照してください。

関連プロジェクト

One-click Deploy
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sinco-lab/mcp-youtube-transcript'

If you have feedback or need assistance with the MCP directory API, please join our Discord server