YouTube MCP Server

YouTube MCP サーバー

YouTube Data API を利用した Model Context Protocol（MCP）サーバーの実装です。標準化されたインターフェースを通じて、AI 言語モデルが YouTube コンテンツを操作できます。

主な機能

動画情報

• 動画の詳細情報（タイトル、説明、再生時間、統計情報）を取得
• キーワードで動画を検索
• 特定の動画に基づいて関連動画を取得
• 動画のエンゲージメント比率を計算・分析

字幕・キャプションの管理

• 多言語に対応した動画の字幕を取得
• 字幕の言語設定を指定
• コンテンツを正確に参照できるタイムスタンプ付き字幕にアクセス

チャンネル分析

• チャンネルの詳細な統計情報（登録者数、再生回数、動画数）を表示
• チャンネルの人気動画を取得
• チャンネルの成長とエンゲージメント指標を分析

トレンド分析

• 地域やカテゴリ別のトレンド動画を表示
• 複数の動画のパフォーマンス指標を比較
• 特定のカテゴリで人気のコンテンツを発見

利用可能なツール

サーバーは以下の MCP ツールを提供します。

ツール名	説明	必須パラメーター
getVideoDetails	メタデータ、統計情報、コンテンツの詳細を含む、複数の YouTube 動画の詳細情報を取得します	videoIds（配列）
searchVideos	クエリ文字列に基づいて動画を検索します	query、maxResults（任意）
getTranscripts	複数の動画の字幕を取得します	videoIds（配列）、lang（任意）
getRelatedVideos	YouTube のおすすめアルゴリズムに基づいて、特定の動画に関連する動画を取得します	videoId、maxResults（任意）
getChannelStatistics	登録者数、再生回数、動画数など、複数のチャンネルの詳細な指標を取得します	channelIds（配列）
getChannelTopVideos	特定のチャンネルの再生回数が最も多い動画を取得します	channelId、maxResults（任意）
getVideoEngagementRatio	複数の動画のエンゲージメント指標（再生回数、高評価数、コメント数、エンゲージメント比率）を計算します	videoIds（配列）
getTrendingVideos	地域やカテゴリ別に、現在人気の動画を取得します	regionCode（任意）、categoryId（任意）、maxResults（任意）
compareVideos	複数の動画の統計情報を比較します	videoIds（配列）

インストール

Smithery による自動インストール

Smithery を使用して、Claude Desktop 用の YouTube MCP Server を自動インストールします。

npx -y @smithery/cli install @icraft2170/youtube-data-mcp-server --client claude

手動インストール

# Install from npm
npm install youtube-data-mcp-server

# Or clone repository
git clone https://github.com/icraft2170/youtube-data-mcp-server.git
cd youtube-data-mcp-server
npm install

環境設定

以下の環境変数を設定します。

• YOUTUBE_API_KEY：YouTube Data API キー（必須）
• YOUTUBE_TRANSCRIPT_LANG：デフォルトの字幕言語（任意、デフォルト：'ko'）

MCP クライアントの設定

Claude Desktop の設定ファイルに以下を追加します。

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": ["-y", "youtube-data-mcp-server"],
      "env": {
        "YOUTUBE_API_KEY": "YOUR_API_KEY_HERE",
        "YOUTUBE_TRANSCRIPT_LANG": "ko"
      }
    }
  }
}

YouTube API の設定

1. Google Cloud Console にアクセスします
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します
3. YouTube Data API v3 を有効にします
4. API 認証情報（API キー）を作成します
5. 生成された API キーを環境設定で使用します

開発

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

ネットワーク設定

サーバーは通信に以下のポートを公開します。

• HTTP：3000
• gRPC：3001

システム要件

• Node.js 18.0.0 以降

セキュリティに関する注意事項

• API キーは常に安全に保管し、バージョン管理システムにコミットしないでください
• 環境変数または設定ファイルを通じて API キーを管理してください
• 不正使用を防ぐため、API キーの使用上限を設定してください

ライセンス

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