YouTube MCP Server

Acceseaza YouTube video data and transcripts cu ajutorul YouTube Data API.

Implementarea unui server Model Context Protocol (MCP) care utilizează API-ul YouTube Data permite modelelor AI să interacționeze cu conținutul YouTube printr-o interfață standardizată.

Caracteristici principale:

• Informații video:
  • Obține informații detaliate despre videoclipuri (titlu, descriere, durată, statistici)
  • Caută videoclipuri după cuvinte cheie
  • Obține videoclipuri conexe pe baza unui anumit videoclip
  • Calculează și analizează ratele de implicare ale videoclipurilor
• Gestionarea transcriptelor/caption-urilor:
  • Recuperează subtitrări pentru videoclipuri cu suport multilingv
  • Specifică preferințe lingvistice pentru transcripturi
  • Accesează subtitrări cu marcaje de timp pentru referințe precise
• Analiza canalelor:
  • Vizualizează statistici detaliate ale canalelor (abonați, vizualizări, număr de videoclipuri)
  • Obține cele mai populare videoclipuri de pe un canal
  • Analizează creșterea și metricile de implicare ale canalului
• Analiza tendințelor:
  • Vizualizează videoclipuri în trend pe regiune și categorie
  • Compară metrici de performanță între mai multe videoclipuri
  • Descoperă conținut popular în categorii specifice

Available Tools

Tool Name	Description	Required Parameters
getVideoDetails	Get detailed information about multiple YouTube videos including metadata, statistics, and content details	videoIds (array)
searchVideos	Search for videos based on a query string	query, maxResults (optional)
getTranscripts	Retrieve transcripts for multiple videos	videoIds (array), lang (optional)
getRelatedVideos	Get videos related to a specific video based on YouTube’s recommendation algorithm	videoId, maxResults (optional)
getChannelStatistics	Retrieve detailed metrics for multiple channels including subscriber count, view count, and video count	channelIds (array)
getChannelTopVideos	Get the most viewed videos from a specific channel	channelId, maxResults (optional)
getVideoEngagementRatio	Calculate engagement metrics for multiple videos (views, likes, comments, and engagement ratio)	videoIds (array)
getTrendingVideos	Get currently popular videos by region and category	regionCode (optional), categoryId (optional), maxResults (optional)
compareVideos	Compare statistics across multiple videos	videoIds (array)

Instalare

Instalare automata via Smithery

Instalati automat YouTube MCP Server pentru Claude Desktop via Smithery:

npx -y @smithery/cli install @icraft2170/youtube-data-mcp-server --client claude

Instalare manuala

# Install from npm
npm install youtube-data-mcp-server

# Or clone repository
git clone https://github.com/icraft2170/youtube-data-mcp-server.git
cd youtube-data-mcp-server
npm install

Configurare mediu

Seteaza urmatoarele variabile de mediu:

• YOUTUBE_API_KEY: YouTube Data API key (required)
• YOUTUBE_TRANSCRIPT_LANG: Default caption language (optional, default: ‘ko’)

MCP Client Configuration

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": ["-y", "youtube-data-mcp-server"],
      "env": {
        "YOUTUBE_API_KEY": "YOUR_API_KEY_HERE",
        "YOUTUBE_TRANSCRIPT_LANG": "ko"
      }
    }
  }
}

YouTube API Setup

1. Access Google Cloud Console
2. Create a new project or select an existing one
3. Enable YouTube Data API v3
4. Create API credentials (API key)
5. Use the generated API key in your environment configuration

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

Network Configuration

The server exposes the following ports for communication:

• HTTP: 3000
• gRPC: 3001

System Requirements

• Node.js 18.0.0 or higher