py-mcp-youtube-toolbox

Сервер MCP, который предоставляет помощникам на базе искусственного интеллекта мощные инструменты для взаимодействия с YouTube, включая поиск видео, извлечение стенограмм, поиск комментариев и многое другое.

Обзор

py-mcp-youtube-toolbox предоставляет следующие функции, связанные с YouTube:

• Поиск видео на YouTube с расширенными возможностями фильтрации

• Получите подробную информацию о видео и каналах

• Извлечение видеокомментариев с возможностью сортировки

• Извлечение видеотранскриптов и субтитров на нескольких языках

• Найти похожие видео для заданного видео

• Получите популярные видео по региону

• Создание резюме видеоконтента на основе расшифровок

• Расширенный анализ стенограмм с возможностями фильтрации, поиска и многовидео

Related MCP server: YouTube MCP Server

Оглавление

• Предпосылки

• Установка

• Настройте параметры MCP

• Инструменты Документация

  • Видео инструменты

  • Инструменты канала

  • Инструменты для расшифровки

  • Инструменты подсказок

  • Инструменты ресурсов

• Разработка

• Лицензия

Предпосылки

1. Python : установите Python 3.12 или выше.

2. API-ключ YouTube :

   • Перейти в Google Cloud Console

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

   • Включите API данных YouTube v3:

     1. Перейдите в раздел «API и службы» > «Библиотека»

     2. Найдите и включите «YouTube Data API v3».

   • Создать учетные данные:

     1. Перейдите в раздел «API и службы» > «Учетные данные».

     2. Нажмите «Создать учетные данные» > «Ключ API».

     3. Запишите свой ключ API.

Установка

Клон Git

git clone https://github.com/jikime/py-mcp-youtube-toolbox.git
cd py-mcp-youtube-toolbox

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

1. Установите менеджер пакетов UV:

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Создать и активировать виртуальную среду:

uv venv -p 3.12
source .venv/bin/activate  # On MacOS/Linux
# or
.venv\Scripts\activate  # On Windows

3. Установить зависимости:

uv pip install -r requirements.txt

4. Переменные среды:

cp env.example .env
vi .env
# Update with your YouTube API key
YOUTUBE_API_KEY=your_youtube_api_key

Использование Докера

1. Создайте образ Docker:

docker build -t py-mcp-youtube-toolbox .

2. Запустите контейнер:

docker run -e YOUTUBE_API_KEY=your_youtube_api_key py-mcp-youtube-toolbox

Использование локального

1. Запустите сервер:

mcp run server.py

2. Запустите MCP Inspector:

mcp dev server.py

Настройте параметры MCP

Добавьте конфигурацию сервера в файл настроек MCP:

Приложение Клод для ПК

1. Для автоматической установки через Smithery :

npx -y @smithery/cli install @jikime/py-mcp-youtube-toolbox --client claude

2. Для ручной установки откройте ~/Library/Application Support/Claude/claude_desktop_config.json

Добавьте это к объекту mcpServers :

{
  "mcpServers": {
    "YouTube Toolbox": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/py-mcp-youtube-toolbox",
        "run",
        "server.py"
      ],
      "env": {
        "YOUTUBE_API_KEY": "your_youtube_api_key"
      }
    }
  }
}

Курсор IDE

открыть ~/.cursor/mcp.json

Добавьте это к объекту mcpServers :

{
  "mcpServers": {
    "YouTube Toolbox": {
      "command": "/path/to/bin/uv",
      "args": [
        "--directory",
        "/path/to/py-mcp-youtube-toolbox",
        "run",
        "server.py"
      ],
      "env": {
        "YOUTUBE_API_KEY": "your_youtube_api_key"
      }
    }
  }
}

для Докера

{
  "mcpServers": {
    "YouTube Toolbox": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "YOUTUBE_API_KEY=your_youtube_api_key",
        "py-mcp-youtube-toolbox"
      ]
    }
  }
}

Инструменты Документация

Видео инструменты

• search_videos : Поиск видео YouTube с расширенными параметрами фильтрации (канал, продолжительность, регион и т. д.)

• get_video_details : Получить подробную информацию о конкретном видео YouTube (название, канал, просмотры, лайки и т. д.)

• get_video_comments : Извлечение комментариев из видео YouTube с возможностью сортировки

• get_related_videos : Найти видео, связанные с определенным видео YouTube

• get_trending_videos : Получите популярные видео на YouTube по региону

Инструменты канала

• get_channel_details : Получить подробную информацию о канале YouTube (название, подписчики, просмотры и т. д.)

Инструменты для расшифровки

• get_video_transcript : Извлечение транскриптов/титров из видео YouTube на указанных языках

• get_video_enhanced_transcript : расширенное извлечение транскриптов с возможностями фильтрации, поиска и работы с несколькими видео

Инструменты подсказок

• transcript_summary : создание резюме видеоконтента YouTube на основе транскриптов с настраиваемыми параметрами

Инструменты ресурсов

• youtube://available-youtube-tools : Получите список всех доступных инструментов YouTube

• youtube://video/{video_id} : Получить подробную информацию о конкретном видео

• youtube://channel/{channel_id} : Получить информацию о конкретном канале

• youtube://transcript/{video_id}?language={language} : Получить расшифровку определенного видео

Разработка

Для локального тестирования вы можете использовать прилагаемый клиентский скрипт:

# Example: Search videos
uv run client.py search_videos query="MCP" max_results=5

# Example: Get video details
uv run client.py get_video_details video_id=zRgAEIoZEVQ

# Example: Get channel details
uv run client.py get_channel_details channel_id=UCRpOIr-NJpK9S483ge20Pgw

# Example: Get video comments
uv run client.py get_video_comments video_id=zRgAEIoZEVQ max_results=10 order=time

# Example: Get video transcript
uv run client.py get_video_transcript video_id=zRgAEIoZEVQ language=ko

# Example: Get related videos
uv run client.py get_related_videos video_id=zRgAEIoZEVQ max_results=5

# Example: Get trending videos
uv run client.py get_trending_videos region_code=ko max_results=10

# Example: Advanced transcript extraction
uv run client.py get_video_enhanced_transcript video_ids=zRgAEIoZEVQ language=ko format=timestamped include_metadata=true start_time=100 end_time=200 query=에이전트 case_sensitive=true segment_method=equal segment_count=2

# Example: 

Лицензия

Лицензия Массачусетского технологического института