Youtube MCP Server 66a

🚀 YouTube MCP Server

A Media Control Protocol (MCP) server integrated with YouTube, allowing you to control YouTube playback across multiple devices.

🚀 Quick Start

1. Start the server:

   npm start
   

2. Use auto-restart during development:

   npm run dev
   

3. Open your browser and navigate to:

   http://localhost:3000
   

✨ Features

• Play, pause, and control YouTube videos from any device.
• Synchronize playback states across multiple clients.
• Search for YouTube videos directly from the interface.
• Control volume and playback position.
• Implement real-time updates using WebSocket.
• Provide a simple and intuitive user interface.

📦 Installation

1. Clone this repository:

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

2. Install dependencies:

   npm install
   

3. Create a .env file based on the .env.example template:

   cp .env.example .env
   

4. Edit the .env file and add your YouTube API key:

   YOUTUBE_API_KEY=your_youtube_api_key_here
   

   You can obtain a YouTube API key from the Google Cloud Console:

   • Create a new project.
   • Enable the YouTube Data API v3.
   • Create API credentials (API Key).

💻 Usage Examples

Basic Usage

npm start

Advanced Usage

npm run dev

📚 Documentation

How It Works

The YouTube MCP server provides you with a central control point to manage YouTube playback across multiple devices. It uses:

• Express.js to provide an HTTP server and API endpoints.
• Socket.io to enable real-time communication between clients and the server.
• YouTube Data API to search for videos and retrieve video information.
• YouTube IFrame API to control video playback.

When a client connects to the server:

1. The client can use the search function to find videos.
2. Play videos on its device.
3. Control playback (play, pause, seek, adjust volume).
4. All commands are broadcast to other connected clients.
5. Clients can synchronize with the current playback state.

API Endpoints

• GET /api/video/:videoId - Get video information.
• GET /api/search?q=query - Search for YouTube videos.
• GET /api/clients - Get a list of connected clients.

WebSocket Events

Client to Server

• play - Play a video.
• pause - Pause the current video.
• stop - Stop playback.
• seek - Jump to a specific position.
• volume - Adjust the volume.
• mute - Mute/unmute.
• updateTimestamp - Update the current playback position.

Server to Client

• playerStateUpdate - Broadcast playback state updates to all clients.

Project Structure

youtube-mcp-server/
├── public/               # Client files
│   ├── index.html        # Main HTML file
│   ├── app.js            # Client JavaScript
│   └── styles.css        # CSS styles
├── server.js             # Main server file
├── package.json          # Dependencies and scripts
└── .env                  # Environment variables (created based on .env.example)

Requirements

• Node.js (v14 or higher)
• npm (v6 or higher)
• A YouTube Data API key

Customization

You can customize the server as needed:

1. Modify the user interface in the public directory.
2. Add more API endpoints in server.js.
3. Extend the Socket.io event handlers to implement additional features.

Troubleshooting

• If you cannot start the server, check if Node.js and npm are installed correctly.
• If you encounter connection issues, ensure that the server is running and the port is open.
• For assistance, refer to the documentation or contact the support team.