Youtubemcp

🚀 YouTube MCP Server

このサーバーは、Model Context Protocol (MCP) を利用し、AIエージェントに自然言語コマンドでYouTube動画を検索し再生する機能を提供します。

🚀 クイックスタート

このサーバーを使用することで、AIエージェントが自然言語でYouTubeの動画を検索し再生できるようになります。以下の手順に従ってセットアップしてください。

✨ 主な機能

• searchVideos：任意のクエリに一致するYouTube動画を検索します。
• playPlaylist：デフォルトのブラウザで動画をプレイリストとして開きます。

📦 インストール

前提条件

1. Node.js 18+ がインストールされていること
2. Google Cloud Console から取得した YouTube Data API v3 キー

YouTube APIキーの取得

1. Google Cloud Console にアクセスします。
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
3. APIs & Services > Library に移動します。
4. "YouTube Data API v3" を検索し、有効にします。
5. APIs & Services > Credentials に移動します。
6. Create Credentials > API Key をクリックします。
7. APIキーをコピーします。

インストール手順

1. リポジトリをクローンします
2. 依存関係をインストールします：

   npm install
   

3. 環境変数を設定します： ルートディレクトリに .env ファイルを作成します（.env.example からコピー）：

   cp .env.example .env
   

   .env を編集し、YOUTUBE_API_KEY を追加します。
4. プロジェクトをビルドします：

   npm run build
   

以下をMCP設定（例: .cursor/mcp.json またはClaude Desktopの設定）に追加します。

{
  "mcpServers": {
    "youtube-mcp": {
      "command": "node",
      "args": ["/path/to/your/project/youtubeMCP/dist/index.js"]
    }
  }
}

⚠️ 重要提示 サーバーは自動的にプロジェクトディレクトリ内の .env ファイルから YOUTUBE_API_KEY を読み込みます。また、上記のJSON設定の env オブジェクトに直接渡すこともできます。

💻 使用例

設定が完了したら、AIエージェントに以下のような質問をすることができます。

• "YouTubeで最高の英語の曲を10曲検索して"
• "リラックスするピアノ曲の動画を5本再生して"
• "テイラー・スウィフトの曲を検索して再生して"
• "コーディングチュートリアルを検索して"

利用可能なツール

searchVideos

クエリでYouTube動画を検索します。

パラメーター:

• query (文字列, 必須): 検索クエリ
• maxResults (数値, オプション): 結果の数 (1 - 50, デフォルト: 10)

playPlaylist

ブラウザで動画を再生します。

パラメーター:

• videoIds (文字列配列, オプション): 再生する動画IDの配列
• query (文字列, オプション): このクエリに一致する動画を検索して再生します
• maxResults (数値, オプション): クエリを使用する場合の動画の数 (デフォルト: 10)

📚 ドキュメント

開発

# 開発用のウォッチモード
npm run dev

# ビルド
npm run build

# 起動
npm start

プロジェクト構造

YouTubeMCP/
├── package.json
├── tsconfig.json
├── README.md
├── src/
│   ├── index.ts           # MCPサーバーのエントリーポイント
│   ├── youtube-client.ts  # YouTube APIラッパー
│   └── tools/
│       ├── search.ts      # searchVideosツール
│       └── play.ts        # playPlaylistツール
└── dist/                  # コンパイルされたJavaScript

📄 ライセンス

MIT