YouTube Transcript MCP Server

YouTube Transcript MCP Server

このプロジェクトは、さまざまな形式で YouTube 動画のトランスクリプトを取得するツールを提供する Model Context Protocol（MCP）サーバーを実装しています。youtube-transcript-api を活用し、LLM が YouTube のトランスクリプトに安全かつ効率的にアクセスできるようにします。

概要

このサーバーは、指定された動画 ID、言語コード、希望する形式に基づいて YouTube 動画のトランスクリプトを取得する fetch_youtube_transcript ツールを公開します。この機能により、LLM は YouTube 動画のトランスクリプトにシームレスにアクセスして処理できます。

機能

• YouTube トランスクリプトの取得： 複数の言語で YouTube 動画のトランスクリプトを取得します。
• 柔軟な出力形式： プレーンテキストまたは JSON 形式でトランスクリプトを取得できます。
• MCP 連携： MCP 対応のクライアントやツールとシームレスに連携するよう設計されています。

MCP クライアントの設定

"mcpServers": {
  "youtube-transcripts": {
    "command": "uv",
    "args": [
      "--directory",
      "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-transcripts/src",
      "run",
      "server.py"
    ]
  }
}

セットアップ

このプロジェクトでは、パッケージとプロジェクトの管理に uv を使用します。 このプロジェクトを実行するには、以下のセットアップ手順に従ってください。

1. まだインストールしていない場合は、uv をインストールします。こちらにインストール手順があります。
2. リポジトリをクローンします。

   git clone https://github.com/PraveenKishore/mcp-server-youtube.git
   cd mcp-server-youtube
   

3. 仮想環境を作成し、依存関係をインストールします。

   uv sync
   

4. 仮想環境を有効にします。

   source .venv/bin/activate  # Activate the virtual environment (Linux/MacOS)
   # OR
   .\.venv\Scripts\activate  # Activate the virtual environment (Windows)
   

5. これで準備完了です！

MCP サーバーのテスト

1. MCP サーバーのみをテストする

MCP Inspector を起動するには、以下のコマンドを実行します。

mcp dev src/server.py

これによりサーバーが起動し、Tools タブで公開されているツールの一覧を確認できます。また、適切な入力を指定して、これらのツールを呼び出すこともできます。

2. Claude Desktop でテストする

Claude Desktop でテストするには、MCP の設定を claude_desktop_config.json ファイルに追加します。 詳しくはこちらのリンクを参照してください。設定が完了すると、Claude Desktop のインターフェースから直接ツールを呼び出せるようになります。

3. mcp-client-cli でテストする

mcp-client-cli は、LLM のプロンプトを実行し、Model Context Protocol（MCP）クライアントを実装するためのシンプルなコマンドラインツールです。 このツールを使用するには、MCP の設定を ~/.llm/config.json に追加します。詳しいセットアップ手順については、公式セットアップガイドを確認してください。設定後は、mcp-client-cli 内でツールを呼び出せるようになります。