YouTube MCP-сервер

Реализация сервера Model Context Protocol (MCP) для YouTube, позволяющая языковым моделям ИИ взаимодействовать с контентом YouTube через стандартизированный интерфейс.

Функции

Видео информация

• Получить сведения о видео (название, описание, продолжительность и т. д.)

• Список видео канала

• Получите статистику видео (просмотры, лайки, комментарии)

• Поиск видео на YouTube

Управление транскриптами

• Получить расшифровки видео

• Поддержка нескольких языков

• Получайте подписи с временной меткой

• Поиск в стенограммах

Управление каналами

• Получить информацию о канале

• Список плейлистов каналов

• Получить статистику канала

• Поиск по содержимому канала

Управление плейлистом

• Список элементов плейлиста

• Получить детали плейлиста

• Поиск в плейлистах

• Получить расшифровки видео плейлиста

Related MCP server: YouTube Translate MCP

Установка

Установка через Smithery

Чтобы автоматически установить YouTube MCP Server для Claude Desktop через Smithery :

npx -y @smithery/cli install @ZubeidHendricks/youtube --client claude

Ручная установка

npm install zubeid-youtube-mcp-server

Конфигурация

Установите следующие переменные среды:

• YOUTUBE_API_KEY : Ваш ключ API данных YouTube

• YOUTUBE_TRANSCRIPT_LANG : язык по умолчанию для транскриптов (необязательно, по умолчанию «en»)

Использование с клиентом MCP

Добавьте это в конфигурацию вашего клиента MCP (например, Claude Desktop):

{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": ["-y", "zubeid-youtube-mcp-server"],
      "env": {
        "YOUTUBE_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Использование с VS Code

Для установки в один клик нажмите одну из кнопок установки ниже:

Ручная установка

Если вы предпочитаете ручную установку, сначала проверьте кнопки установки в верхней части этого раздела. В противном случае выполните следующие действия:

Добавьте следующий блок JSON в файл настроек пользователя (JSON) в VS Code. Это можно сделать, нажав Ctrl + Shift + P и введя Preferences: Open User Settings (JSON) .

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "YouTube API Key",
        "password": true
      }
    ],
    "servers": {
      "youtube": {
        "command": "npx",
        "args": ["-y", "zubeid-youtube-mcp-server"],
        "env": {
          "YOUTUBE_API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

При желании вы можете добавить его в файл .vscode/mcp.json в своей рабочей области:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apiKey",
      "description": "YouTube API Key",
      "password": true
    }
  ],
  "servers": {
    "youtube": {
      "command": "npx",
      "args": ["-y", "zubeid-youtube-mcp-server"],
      "env": {
        "YOUTUBE_API_KEY": "${input:apiKey}"
      }
    }
  }
}

Настройка API YouTube

1. Перейти в Google Cloud Console

2. Создайте новый проект или выберите существующий

3. Включить API данных YouTube v3

4. Создать учетные данные API (ключ API)

5. Скопируйте ключ API для конфигурации

Примеры

Управление видео

// Get video details
const video = await youtube.videos.getVideo({
  videoId: "video-id"
});

// Get video transcript
const transcript = await youtube.transcripts.getTranscript({
  videoId: "video-id",
  language: "en"
});

// Search videos
const searchResults = await youtube.videos.searchVideos({
  query: "search term",
  maxResults: 10
});

Управление каналами

// Get channel details
const channel = await youtube.channels.getChannel({
  channelId: "channel-id"
});

// List channel videos
const videos = await youtube.channels.listVideos({
  channelId: "channel-id",
  maxResults: 50
});

Управление плейлистами

// Get playlist items
const playlistItems = await youtube.playlists.getPlaylistItems({
  playlistId: "playlist-id",
  maxResults: 50
});

// Get playlist details
const playlist = await youtube.playlists.getPlaylist({
  playlistId: "playlist-id"
});

Разработка

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Lint
npm run lint

Внося вклад

Информацию о внесении вклада в этот репозиторий см. на сайте CONTRIBUTING.md.

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.