YouTube MCP-сервер
Реализация сервера Model Context Protocol (MCP) для YouTube, позволяющая языковым моделям ИИ взаимодействовать с контентом YouTube через стандартизированный интерфейс.
Функции
- Получить сведения о видео (название, описание, продолжительность и т. д.)
- Список видео канала
- Получите статистику видео (просмотры, лайки, комментарии)
- Поиск видео на YouTube
Управление транскриптами
- Получить расшифровки видео
- Поддержка нескольких языков
- Получайте подписи с временной меткой
- Поиск в стенограммах
Управление каналами
- Получить информацию о канале
- Список плейлистов каналов
- Получить статистику канала
- Поиск по содержимому канала
Управление плейлистом
- Список элементов плейлиста
- Получить детали плейлиста
- Поиск в плейлистах
- Получить расшифровки видео плейлиста
Установка
Установка через 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 данных YouTubeYOUTUBE_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
- Перейти в Google Cloud Console
- Создайте новый проект или выберите существующий
- Включить API данных YouTube v3
- Создать учетные данные API (ключ API)
- Скопируйте ключ 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.