Сервер MCP, который предоставляет помощникам на базе искусственного интеллекта мощные инструменты для взаимодействия с YouTube, включая поиск видео, извлечение стенограмм, поиск комментариев и многое другое.
Обзор
py-mcp-youtube-toolbox предоставляет следующие функции, связанные с YouTube:
- Поиск видео на YouTube с расширенными возможностями фильтрации
- Получите подробную информацию о видео и каналах
- Извлечение видеокомментариев с возможностью сортировки
- Извлечение видеотранскриптов и субтитров на нескольких языках
- Найти похожие видео для заданного видео
- Получите популярные видео по региону
- Создание резюме видеоконтента на основе расшифровок
- Расширенный анализ стенограмм с возможностями фильтрации, поиска и многовидео
Оглавление
Предпосылки
- Python : установите Python 3.12 или выше.
- API-ключ YouTube :
- Перейти в Google Cloud Console
- Создайте новый проект или выберите существующий
- Включите API данных YouTube v3:
- Перейдите в раздел «API и службы» > «Библиотека»
- Найдите и включите «YouTube Data API v3».
- Создать учетные данные:
- Перейдите в раздел «API и службы» > «Учетные данные».
- Нажмите «Создать учетные данные» > «Ключ API».
- Запишите свой ключ API.
Установка
Клон Git
git clone https://github.com/jikime/py-mcp-youtube-toolbox.git
cd py-mcp-youtube-toolbox
Конфигурация
- Установите менеджер пакетов UV:
curl -LsSf https://astral.sh/uv/install.sh | sh
- Создать и активировать виртуальную среду:
uv venv -p 3.12
source .venv/bin/activate # On MacOS/Linux
# or
.venv\Scripts\activate # On Windows
- Установить зависимости:
uv pip install -r requirements.txt
- Переменные среды:
cp env.example .env
vi .env
# Update with your YouTube API key
YOUTUBE_API_KEY=your_youtube_api_key
Использование Докера
- Создайте образ Docker:
docker build -t py-mcp-youtube-toolbox .
- Запустите контейнер:
docker run -e YOUTUBE_API_KEY=your_youtube_api_key py-mcp-youtube-toolbox
Использование локального
- Запустите сервер:
- Запустите MCP Inspector:
Настройте параметры MCP
Добавьте конфигурацию сервера в файл настроек MCP:
Приложение Клод для ПК
- Для автоматической установки через Smithery :
npx -y @smithery/cli install @jikime/py-mcp-youtube-toolbox --client claude
- Для ручной установки откройте
~/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 : Найти видео, связанные с определенным видео YouTubeget_trending_videos : Получите популярные видео на YouTube по региону
Инструменты канала
get_channel_details : Получить подробную информацию о канале YouTube (название, подписчики, просмотры и т. д.)
Инструменты для расшифровки
get_video_transcript : Извлечение транскриптов/титров из видео YouTube на указанных языкахget_video_enhanced_transcript : расширенное извлечение транскриптов с возможностями фильтрации, поиска и работы с несколькими видео
Инструменты подсказок
transcript_summary : создание резюме видеоконтента YouTube на основе транскриптов с настраиваемыми параметрами
Инструменты ресурсов
youtube://available-youtube-tools : Получите список всех доступных инструментов YouTubeyoutube://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:
Лицензия
Лицензия Массачусетского технологического института