Youtube MCP Server

🚀 YouTube MCP Server

This YouTube MCP Server is a tool based on the Model Context Protocol (MCP) for interacting with the YouTube Data API and subtitle scraper. It allows access to video information and subtitle data through a unified interface.

🚀 Quick Start

The YouTube MCP Server enables you to interact with YouTube Data API and subtitle scraper via a unified interface. With it, you can easily access video information and subtitle data.

✨ Features

• Retrieve detailed video information
• Extract subtitles
• Search for related videos
• Analyze content
• Support output in multiple formats

📦 Installation

Method 1: Using npm

npm install youtube-mcp-server

Method 2: Building from source code

1. Clone the repository:

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. Install dependencies:

   npm install
   

3. Start the server:

   npm start
   

💻 Usage Examples

Basic Usage

Initializing the MCP proxy

const { MCP } = require('youtube-mcp-server');
const mcp = new MCP({
  apiKey: 'your_api_key', // Replace with your YouTube API key
  models: ['gpt-3.5-turbo'] // List of supported models
});

Getting video information

async function getVideoInfo(videoId) {
  try {
    const result = await mcp.query({
      type: 'query',
      query: {
        video: {
          id: videoId
        }
      }
    });
    return result;
  } catch (error) {
    console.error('Failed to get video information:', error.message);
    return null;
  }
}

Extracting subtitles

async function extractSubtitles(videoId, language = 'zh-CN') {
  try {
    const result = await mcp.query({
      type: 'extract',
      extractor: {
        youtube: {
          videoId,
          language
        }
      }
    });
    return result;
  } catch (error) {
    console.error('Failed to extract subtitles:', error.message);
    return null;
  }
}

Advanced Usage

Video information query

const videoInfo = await getVideoInfo('dQw4w9WgXcQ');
console.log(videoInfo);
// Example output:
// {
//   id: 'dQw4w9WgXcQ',
//   title: '什么是什么？', // Example title
//   channel: 'PewDiePro', // Example channel name
//   views: '100万', // Example view count
//   likes: '10万' // Example like count
// }

Subtitle extraction and analysis

const subtitles = await extractSubtitles('dQw4w9WgXcQ');
console.log(subtitles);
// Example output:
// [
//   {
//     timestamp: '00:01:23', // Example timestamp
//     text: '这是第一个字幕条。' // Example subtitle text
//   },
//   ...
// ]

📚 Documentation

Error Handling

The server handles various error conditions, including:

• Invalid API key
• Video or channel not found
• Subtitles unavailable
• Network issues

📄 License

MIT

👏 Acknowledgments

Thanks for the support of the following projects and libraries:

• Model Context Protocol TypeScript SDK
• YouTube Data API
• YouTube Captions Scraper