Youtube Transcript Downloader

🚀 YouTube MCP サーバー

このサーバーは、YouTube API と AI アシスタントの間の架け橋として機能し、モデルコンテキストプロトコルに基づいています。

🚀 クイックスタート

このサーバーは YouTube API と AI アシスタントの間の橋渡しをします。以下のセクションでは、サーバーの詳細、インストール方法、設定方法、開発方法、トラブルシューティング方法について説明します。

✨ 主な機能

• 与えられた動画のクローズドキャプションをダウンロードします。
• 動画の要約を作成します。

📦 インストール

前提条件

• uv ツール

インストールコマンド

uv tool install git+https://github.com/sparfenyuk/mcp-youtube

⚠️ 重要提示

すでにサーバーをインストールしている場合は、uv tool upgrade --reinstall コマンドを使用して更新できます。

⚠️ 重要提示

サーバーを削除する場合は、uv tool uninstall mcp-youtube コマンドを使用してください。

💻 使用例

基本的な使用法

このサーバーの主な機能は、与えられた動画のクローズドキャプションをダウンロードすることです。また、動画の要約を作成することもできます。

📚 ドキュメント

Claude Desktop の設定

Claude Desktop を設定して、YouTube MCP サーバーを認識させます。

1. Claude Desktop の設定ファイルを開きます。

   • MacOS の場合、設定ファイルは ~/Library/Application Support/Claude/claude_desktop_config.json にあります。
   • Windows の場合、設定ファイルは %APPDATA%\Claude\claude_desktop_config.json にあります。

   ⚠️ 重要提示

   Claude Desktop アプリの設定で claude_desktop_config.json ファイルを見つけることもできます。

2. サーバー設定を追加します。

   {
     "mcpServers": {
       "mcp-youtube": {
           "command": "mcp-youtube"
         }
       }
     }
   }
   

🔧 技術詳細

開発の入門ガイド

1. リポジトリをクローンします。

2. 依存関係をインストールします。

   uv sync
   

3. サーバーを起動します。

   uv run mcp-youtube --help
   

ツールは src/mcp_youtube/tools.py ファイルに追加できます。

新しいツールの追加方法

1. ToolArgs を継承した新しいクラスを作成します。

   class NewTool(ToolArgs):
       """新しいツールの説明。"""
       pass
   

   クラスの属性はツールのパラメータとして使用され、クラスのドキュメント文字列はツールの説明として使用されます。

2. 新しいツールの tool_runner 関数を実装します。

   @tool_runner.register
   async def new_tool(args: NewTool) -> t.Sequence[TextContent | ImageContent | EmbeddedResource]:
       pass
   

   この関数は TextContent、ImageContent または EmbeddedResource を含むシーケンスを返す必要があります。関数は非同期で、新しいクラスのパラメータを受け取る必要があります。

3. 完了！クライアントを再起動すると、新しいツールが使用可能になります。

Inspector でサーバーをデバッグする

MCP インスペクターは、美しい UI を使用してサーバーをデバッグするためのツールです。実行するには、以下のコマンドを使用します。

npx @modelcontextprotocol/inspector uv run mcp-youtube

📄 ライセンス

元の README でライセンス情報が提供されていないため、このセクションは表示されません。

🛠️ トラブルシューティング

「MCP サーバー mcp-youtube に接続できません」というメッセージ

設定ファイルで mcp-youtube 実行可能ファイルの完全パスをコマンドライン引数に追加してください。