Youtube Knowledge MCP

🚀 YouTube Knowledge MCP

YouTubeをクエリ可能な知識ソースに変える、本番環境で使用可能なモデルコンテキストプロトコル（MCP）サーバーです。検索、詳細情報の取得、トランスクリプトやコメントの分析を行い、オプションで大規模言語モデル（LLM）を使ってAIワークフローを強化できます。Claude Desktopやその他のMCPクライアント向けに構築されています。

🚀 クイックスタート

YouTube Knowledge MCPは、YouTubeを知識ソースとして活用するためのMCPサーバーです。このサーバーを使うことで、YouTubeの動画を検索、分析し、AIを活用したワークフローを実現できます。

✨ 主な機能

• 高速かつクォータを考慮した：キャッシュ機能を備えた高速なYouTube APIアクセス
• 充実したツール：検索、詳細情報取得、トレンド動画取得、チャンネル検索などのツールが用意されています
• オプションのAI機能：OpenAIやAnthropicを使った要約、トピック分析、章生成、学習パス生成、コメント意図分析、知識グラフ生成などの機能が利用可能です
• ノイズのない環境：最小限の設定、明確なログ、安全なデフォルト設定で、使いやすい環境を提供します

📦 インストール

必要条件

• Node.js 18+
• YouTube Data API v3キー
• オプション：AIツールを使用する場合は、OpenAIおよび/またはAnthropicのAPIキー

インストール手順

npm install

環境設定

.envファイルを作成するか、MCPクライアントの設定で変数を設定します。以下のコマンドでサンプルファイルをコピーできます。

cp env.example .env

その後、.envファイルに以下の値を設定します。

# 必須
YOUTUBE_API_KEY=your_youtube_api_key

# オプションのAIプロバイダー（AIツールを有効にする場合）
# analyze_video_content, generate_learning_path, analyze_comment_intents, simplify_video_transcript, generate_video_chapters, generate_knowledge_graph
OPENAI_API_KEY=your_openai_api_key
ANTHROPIC_API_KEY=your_anthropic_api_key

# オプションの調整
LOG_LEVEL=info
MAX_DAILY_QUOTA=8000
REDIS_URL= # 例: redis://localhost:6379
REDIS_HOST=
REDIS_PORT=
REDIS_PASSWORD=

プレースホルダー付きのenv.exampleファイルが提供されています。.envファイルはコミットしないでください。

ビルドと実行

# 開発環境（自動リロード）
npm run dev

# 本番環境
npm run build
npm start

Claude Desktopへの接続（例）

Claude Desktopの設定に絶対パスを指定して追加します。

{
  "mcpServers": {
    "youtube-knowledge": {
      "command": "node",
      "args": ["/absolute/path/to/youtube-knowledge-mcp/build/index.js"],
      "env": {
        "YOUTUBE_API_KEY": "your_youtube_api_key",
        "OPENAI_API_KEY": "optional_openai",
        "ANTHROPIC_API_KEY": "optional_anthropic",
        "LOG_LEVEL": "info"
      }
    }
  }
}

設定を編集した後、Claude Desktopを再起動してください。

💻 使用例

基本的な使用法

以下は、利用可能なツールの一部です。

• youtube_search — フィルター付きで動画を検索します
• get_video_details — 動画のメタデータ、トランスクリプト（できる限り取得）、コメントを取得します
• get_trending_videos — 地域やカテゴリー別の人気動画を取得します
• search_channels — オプションで統計情報付きでチャンネルを検索します
• analyze_video_content — AIを使ってトピック、センチメント、質問、要約、キーワードを分析します
• generate_learning_path — トピックに関するAI学習パスを生成します
• analyze_comment_intents — 視聴者の意図を分類します
• simplify_video_transcript — ELI5スタイルでトランスクリプトを簡略化します
• generate_video_chapters — AIを使ってタイムスタンプ付きの章を生成します
• generate_knowledge_graph — 動画間の概念グラフを生成します

注意：AIツールは、AIプロバイダーのキーが設定されている場合のみ利用可能です。

🔧 技術詳細

• クォータと安全性：毎日のクォータ（デフォルトで8000ユニット）を制限し、コストを考慮したAIの使用を行います。stderrにログを出力し（MCPのstdioを壊さない）、キャッシュによりAPIとトークンの使用量を削減します。オプションでRedisをサポートしています。
• トラブルシューティング
  • キーが不足している場合：YOUTUBE_API_KEYが設定されていることを確認してください。
  • クォータを超過した場合：使用量を減らすか、キャッシュを有効にするか、MAX_DAILY_QUOTAを増やしてください。
  • Claudeが接続できない場合：build/index.jsの絶対パスを確認し、再起動してください。

📄 ライセンス

MIT By Efi Kuta