Сервер YouTube Transcript

Сервер протокола контекста модели, который обеспечивает извлечение расшифровок (субтитров) из видео на YouTube. Этот сервер предоставляет прямой доступ к субтитрам и заголовкам видео через простой интерфейс.

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

Для автоматической установки Сервера YouTube Transcript для Claude Desktop через Smithery:

npx -y @smithery/cli install @kimtaeyoon83/mcp-server-youtube-transcript --client claude

Компоненты

Инструменты

• get_transcript
• Извлекает расшифровки из видео YouTube.
• Входные параметры:
  • url (строка, обязательный): URL видео YouTube, URL Shorts или ID видео.
  • lang (строка, необязательный, по умолчанию: "en"): Код языка для расшифровки (например, 'ko', 'en'). Автоматически откатывается к доступным языкам, если указанный язык не найден.
  • include_timestamps (булево, необязательный, по умолчанию: false): Включать временные метки в вывод (например, '[0:05] текст').
  • strip_ads (булево, необязательный, по умолчанию: true): Фильтровать спонсорства, рекламы и промо-контент из расшифровки на основе маркеров глав.

Основные особенности

• Поддержка нескольких форматов URL видео (включая YouTube Shorts)
• Получение расшифровки для конкретного языка с автоматическим откатом
• Опциональные временные метки для ссылки на конкретные моменты
• Встроенная фильтрация рекламы/спонсорств (включена по умолчанию)
• Отсутствие внешних зависимостей для получения расшифровки
• Подробные метаданные в ответах

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

Для использования с Claude Desktop добавьте эту конфигурацию сервера:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
    }
  }
}

Установка через инструмент

mcp-get Инструмент командной строки для установки и управления серверами протокола контекста модели (MCP).

npx @michaellatman/mcp-get@latest install @kimtaeyoon83/mcp-server-youtube-transcript

Awesome-mcp-servers

awesome-mcp-servers Тщательно подобранный список замечательных серверов протокола контекста модели (MCP).

Разработка

Предварительные требования

• Node.js 18 или выше
• npm или yarn

Настройка

Установите зависимости:

npm install

Соберите сервер:

npm run build

Для разработки с автоматической пересборкой:

npm run watch

Тестирование

npm test

Отладка

Поскольку серверы MCP взаимодействуют через stdio, отладка может быть сложной. Мы рекомендуем использовать MCP Inspector для разработки:

npm run inspector

Запуск evals

Пакет evals загружает клиент mcp, который затем запускает файл index.ts, поэтому нет необходимости пересобирать проект между тестами. Вы можете загружать переменные среды, добавляя префикс к команде npx. Полная документация доступна здесь.

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

Обработка ошибок

Сервер реализует надежную обработку ошибок для типичных сценариев: - Неверные URL или ID видео - Недоступные расшифровки - Проблемы с доступностью языков - Сетевые ошибки

Примеры использования

1. Получение расшифровки по URL видео:

await server.callTool("get_transcript", {
  url: "https://www.youtube.com/watch?v=VIDEO_ID",
  lang: "en"
});

1. Получение расшифровки по ID видео:

await server.callTool("get_transcript", {
  url: "VIDEO_ID",
  lang: "ko"
});

1. Получение расшифровки из YouTube Shorts:

await server.callTool("get_transcript", {
  url: "https://www.youtube.com/shorts/VIDEO_ID"
});

1. Получение расшифровки с временными метками:

await server.callTool("get_transcript", {
  url: "VIDEO_ID",
  include_timestamps: true
});

1. Получение исходной расшифровки без фильтрации рекламы:

await server.callTool("get_transcript", {
  url: "VIDEO_ID",
  strip_ads: false
});

1. Как извлечь субтитры YouTube в приложении Claude Desktop

chat: https://youtu.be/ODaHJzOyVCQ?si=aXkJgso96Deri0aB Извлечь субтитры

Соображения по безопасности

Сервер: - Валидирует все входные параметры - Корректно обрабатывает ошибки API YouTube - Реализует тайм-ауты для получения расшифровки - Предоставляет подробные сообщения об ошибках для устранения неполадок

Лицензия

Этот сервер MCP лицензирован в соответствии с лицензией MIT. Подробности см. в файле LICENSE.