Youtube MCP Server 66a

🚀 YouTube MCP サーバー

このサーバーは、YouTube を統合したメディアコントロールプロトコル (MCP) サーバーで、複数のデバイス間で YouTube の再生を制御できます。

🚀 クイックスタート

YouTube MCP サーバーを使用することで、複数のデバイスを越えて YouTube の再生を制御できます。以下に、サーバーのセットアップと使用方法を説明します。

✨ 主な機能

• 任意のデバイスから YouTube 動画の再生、一時停止、制御が可能
• 複数のクライアントの再生状態を同期
• インターフェースから直接 YouTube 動画を検索
• 音量と再生位置の制御
• WebSocket を使用したリアルタイム更新
• シンプルで直感的なユーザーインターフェース

📦 インストール

1. このリポジトリをクローンします：

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

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

   npm install
   

3. .env.example テンプレートを元に .env ファイルを作成します：

   cp .env.example .env
   

4. .env ファイルを編集し、YouTube API キーを追加します：

   YOUTUBE_API_KEY=your_youtube_api_key_here
   

   YouTube API キーは Google Cloud Console から取得できます。

   • 新しいプロジェクトを作成
   • YouTube Data API v3 を有効化
   • API 認証情報（API キー）を作成

💻 使用例

基本的な使用法

1. サーバーを起動します：

   npm start
   

2. 開発時に自動再起動を使用する場合は：

   npm run dev
   

3. ブラウザを開き、以下の URL にアクセスします：

   http://localhost:3000
   

📚 ドキュメント

仕組み

YouTube MCP サーバーは、複数のデバイスで YouTube の再生を制御するための中央制御ポイントを提供します。以下の技術を使用しています：

• Express.js：HTTP サーバーと API エンドポイントを提供
• Socket.io：クライアントとサーバー間のリアルタイム通信を実現
• YouTube Data API：動画を検索し、動画情報を取得
• YouTube IFrame API：動画の再生を制御

クライアントがサーバーに接続すると：

1. クライアントは検索機能を使用して動画を探すことができます
2. デバイス上で動画を再生できます
3. 再生を制御（再生、一時停止、シーク、音量調整）できます
4. すべてのコマンドは他の接続されたクライアントにブロードキャストされます
5. クライアントは現在の再生状態と同期できます

API エンドポイント

• GET /api/video/:videoId - 動画情報を取得
• GET /api/search?q=query - YouTube 動画を検索
• GET /api/clients - 接続されたクライアントのリストを取得

WebSocket イベント

クライアントからサーバー

• play - 動画を再生
• pause - 現在の動画を一時停止
• stop - 再生を停止
• seek - 特定の位置にシーク
• volume - 音量を調整
• mute - ミュート/ミュート解除
• updateTimestamp - 現在の再生位置を更新

サーバーからクライアント

• playerStateUpdate - すべてのクライアントに再生状態の更新をブロードキャスト

プロジェクト構造

youtube-mcp-server/
├── public/               # クライアントファイル
│   ├── index.html        # メイン HTML ファイル
│   ├── app.js            # クライアント JavaScript
│   └── styles.css        # CSS スタイル
├── server.js             # サーバーのメインファイル
├── package.json          # 依存関係とスクリプト
└── .env                  # 環境変数（.env.example を元に作成）

要件

• Node.js (v14 以上)
• npm (v6 以上)
• YouTube Data API キー

カスタマイズ

サーバーは必要に応じてカスタマイズできます。

1. public ディレクトリ内のユーザーインターフェースを変更
2. server.js で追加の API エンドポイントを追加
3. Socket.io イベントハンドラーを拡張して、追加の機能を実装

トラブルシューティング

• サーバーが起動しない場合は、Node.js と npm が正しくインストールされていることを確認してください。
• 接続問題が発生した場合は、サーバーが実行中で、ポートが開いていることを確認してください。
• ヘルプが必要な場合は、ドキュメントを参照するか、サポートチームに連絡してください。