MCP Server Youtube

🚀 MCP YouTube サーバー

このサーバーは、シンプルなモデルコンテキストプロトコル（MCP）サーバーで、YouTube とのやり取りを可能にするツールを提供します。MCP ホストアプリケーション（例：デスクトップ版のClaude）が以下の操作を実行できるようにします。

• YouTube 動画を検索する。
• 特定の YouTube 動画の詳細情報を取得する。

🚀 クイックスタート

✨ 主な機能

• YouTube 動画の検索機能。
• 特定の YouTube 動画の詳細情報取得機能。

📦 インストール

必要条件

• Python 3.10 以上。
• uv（実行設定の前にインストールする必要があります）。
• YouTube データ API v3 キー。Google Cloud Console から取得できます。
• bash 互換のシェル（主に Linux/macOS の実行設定スクリプト用）。

インストール手順

1. リポジトリをクローンする：

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

2. 設定スクリプトを実行する：

   • uv がインストールされていることを確認します（pip install uv または uv インストールを参照）。
   • mcp-server-youtube ディレクトリ内で以下を実行します：

     bash setup.sh
     

   • このスクリプトは以下のことを行います：
     • uv をチェックします。
     • mcp-server-youtube 内に仮想環境（.venv）を作成します。
     • 依存関係をインストールします (uv sync)。
     • YouTube API キーの入力を求め、.env ファイルを作成します。
     • サーバーのラッパースクリプトを実行可能にします。
     • 最終的な説明と MCP ホスト構成に必要なパスを表示します。

3. MCP ホストを構成する：

   • setup.sh スクリプトの末尾に表示される説明に従います。
   • 提供された「ラッパースクリプトのパス」をコピーします。
   • このパスを MCP ホスト構成ファイル（例：claude_desktop_config.json）の command フィールドに貼り付け、args を空のリストにします。

📚 ドキュメント

構成詳細（.env）

setup.sh スクリプトは、YouTube データ API v3 キーの入力を求め、以下の内容の .env ファイルを作成します。

YOUTUBE_API_KEY=YOUR_API_KEY_HERE

キーを変更する必要がある場合は、この .env ファイルを直接編集してください。

MCP ホストとの連携

• デスクトップ版のClaudeでサーバーを構成する場合は、その構成ファイルを変更する必要があります。具体的なパスはスクリプトの出力を参照してください。
• ラッパースクリプトのパスを構成ファイルに正しく貼り付け、ツールが正常に呼び出せるようにしてください。

💻 使用例

基本的な使用法

このサーバーは、YouTube とのやり取りを行うための複数のツールを提供します。

• 動画を検索する：キーワードを使用して関連する動画を検索します。
• 詳細情報を取得する：特定の動画のメタデータ（タイトル、再生回数など）を取得します。

🤝 貢献

貢献を歓迎します！改善提案やバグ修正がある場合は、自由にイシューやプルリクエストを提出してください。

📄 ライセンス

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