Youtube MCP 8cbced6e

MCPAI代理

提供方 roquevaamonde

AI代理 stdio · 本地进程 API Key 官方维护 VS Code
查看接入方式

一个基于Model Context Protocol (MCP)的工具,用于从YouTube搜索并直接在浏览器中播放音乐。

一句话选型结论

按资料字段整理

Youtube MCP 8cbced6e 属于AI代理类 MCP 服务器,stdio · 本地进程,API Key,可直接接入 VS Code,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权API Key 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 2 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 官方维护 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量2暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

YouTubeAPIPython本地部署音乐搜索浏览器播放多平台支持MCP集成

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
python -m venv venv

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 2 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 2 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 VS Code,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 VS Code 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Youtube MCP 8cbced6e当前 2 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方roquevaamonde上游标注的维护方 roquevaamonde
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式API Key远程服务建议用最小权限凭据
维护方官方维护核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.3 KB
来自项目仓库与上游目录的原文,未做删改

YouTube MCP

Una implementación de Model Context Protocol (MCP) para buscar y reproducir canciones en YouTube directamente desde tu navegador.

Tabla de Contenidos

  • Características
  • Instalación
  • Uso
  • Tests
  • Calidad de Código
  • Estructura del Proyecto
  • Herramientas Disponibles
  • Ejemplos de Prompts
  • Requisitos de API Key
  • Soporte de Sistemas Operativos
  • Licencia
  • Contribuciones

Características

  • 🔍 Buscar canciones en YouTube usando la API oficial
  • 🎵 Reproducir canciones en el navegador automáticamente
  • 🖥️ Soporte multi-plataforma (Windows, macOS, Linux)
  • 📦 Fácil integración con herramientas que soporten MCP
  • ✅ Validación completa de inputs (API Keys, URLs, búsquedas)
  • 📝 Type hints modernos (Python 3.9+)
  • 🧪 Cobertura de tests completa (59 tests, 100% passing)
  • 📊 Logging estructurado y centralización de configuración

Instalación

1. Clonar/Crear el proyecto```bash

cd youtube_mcp

O: git clone https://github.com/roquevaamonde/youtube-mcp.git youtube_mcp


### 2. Crear el virtual environment```bash
python -m venv venv
source venv/bin/activate  # En Windows: venv\Scripts\activate

3. Instalar dependencias```bash

pip install -r requirements.txt


### 4. Configurar API Key

Sigue estos pasos para obtener tu API Key de YouTube:

1. **Acceder a Google Cloud Console**: Dirígete a Google Cloud Console
2. **Crear un nuevo proyecto**:
   - Haz clic en el selector de proyecto en la parte superior
   - Selecciona "Nuevo Proyecto"
   - Asigna un nombre (ej: "YouTube MCP")
   - Clic en "Crear"
3. **Habilitar YouTube Data API v3**:
   - Ve a APIs & Services > Library
   - Busca "YouTube Data API v3"
   - Haz clic en el resultado
   - Clic en "Habilitar"
4. **Crear una API Key**:
   - Ve a APIs & Services > Credentials
   - Clic en "Crear credenciales" → "Clave de API"
   - Copia la clave generada
5. **Configurar en tu proyecto**:```bash
cp .env.example .env
# Edita .env y añade tu YOUTUBE_API_KEY
# YOUTUBE_API_KEY=tu_clave_aqui

5. Configurar en VS Code

  1. Abre las configuraciones de VS Code (Cmd+Shift+P → "Preferences: Open User Settings (JSON)")
  2. Localiza o crea la sección "modelContextProtocol"
  3. Agrega la configuración del servidor YouTube:```json
    {
    "modelContextProtocol": {
    "servers": {
    "youtube": {
    "type": "stdio",
    "command": "{python-path}",
    "args": ["{project-path}/youtube_mcp_server.py"],
    "disabled": false,
    "autoApprove": [],
    "env": {
    "YOUTUBE_API_KEY": "your_api_key_here"
    }
    }
    }
    }
    }

Reemplaza:
- `{python-path}`: Ruta completa a tu Python (ej: `/usr/bin/python3` o `C:\Python\python.exe`)
- `{project-path}`: Ruta del proyecto (ej: `/home/user/projects/youtube_mcp`)
- `your_api_key_here`: Tu API Key de YouTube

## Uso```python
from youtube_mcp.server import YouTubeMCPServer

server = YouTubeMCPServer(api_key="your_api_key")

# Ejemplo 1: Reproducir el primer resultado (tema suelto)
results = server.handle_search_youtube(query="Bohemian Rhapsody Queen", max_results=5)
if results.get("success") and results.get("results"):
    first_url = results["results"][0]["url"]
    server.handle_play_youtube(first_url)

Snippets MCP (JSON) para el mismo flujo:```json
{
"tool": "search_youtube",
"params": {
"query": "Bohemian Rhapsody Queen",
"max_results": 5
}
}


Con el `url` del primer resultado devuelto, reproducir:```json
{
  "tool": "play_youtube",
  "params": {
    "url": "https://www.youtube.com/watch?v=<VIDEO_ID>"
  }
}

Ejemplos avanzados

  • Playlist con orden explícito (por IDs conocidos):

Python:python video_ids = ["VIDEO1", "VIDEO2", "VIDEO3", "VIDEO4"] # Método recomendado (determinista): watch_videos con video_ids playlist_url = f"https://www.youtube.com/watch_videos?video_ids={','.join(video_ids)}" server.handle_play_youtube(playlist_url)

JSON MCP:json { "tool": "play_youtube", "params": { "url": "https://www.youtube.com/watch_videos?video_ids=VIDEO1,VIDEO2,VIDEO3,VIDEO4" } }

Alternativa (menos determinista en algunos navegadores):json { "tool": "play_youtube", "params": { "url": "https://www.youtube.com/watch?v=VIDEO1&playlist=VIDEO2,VIDEO3,VIDEO4&autoplay=1" } }

  • Reproducción continua (Mix de YouTube) para un tema:

Python:python video_id = "VIDEO_ID" mix_url = f"https://www.youtube.com/watch?v={video_id}&list=RD{video_id}&autoplay=1" server.handle_play_youtube(mix_url)

JSON MCP:json { "tool": "play_youtube", "params": { "url": "https://www.youtube.com/watch?v=VIDEO_ID&list=RDVIDEO_ID&autoplay=1" } }

Tests```bash

pytest tests/


**Cobertura de Tests**: 59 tests que cubren:
- ✅ Búsqueda de canciones en YouTube (YouTubeClient)
- ✅ Reproducción de videos en navegador (BrowserController)
- ✅ Detección de Sistema Operativo (Windows, macOS, Linux, WSL)
- ✅ Gestión de procesos de navegador
- ✅ Validadores de URL, API Keys, búsquedas y max_results
- ✅ Servidor MCP y orquestación de herramientas
- ✅ Manejo de errores y casos edge

Para ver la cobertura de código:```bash
pytest tests/ --cov=youtube_mcp --cov-report=term-missing

Calidad de Código

Este proyecto incluye:

  • Validación de inputs: Módulo validators.py con validación completa para:
  • API Keys (longitud mínima 20 caracteres)
  • URLs de YouTube (validación con regex)
  • Queries de búsqueda (1-300 caracteres)
  • Max results (1-50)

  • Type hints modernos: Uso de dict, list, tuple en lugar de typing (Python 3.9+)

  • Logging estructurado: Setup centralizado con logger.py

  • Constantes: Configuración centralizada en constants.py para:

  • Mensajes de error y éxito
  • Detectores de SO (Windows, macOS, Linux, WSL)
  • Configuración por defecto (región, max_results)
  • Formato de logging

Estructura del proyecto```

youtube_mcp/
├── youtube_mcp/
│ ├── init.py
│ ├── youtube_client.py # Cliente de YouTube API
│ ├── browser_controller.py # Controlador de navegador multi-plataforma
│ ├── server.py # Servidor MCP con herramientas
│ ├── validators.py # Validación de inputs
│ ├── constants.py # Constantes y configuración centralizada
│ └── logger.py # Setup de logging
├── tests/ # Tests con pytest (59 tests, 100% passing)
├── config/ # Archivos de configuración
├── docs/ # Documentación
├── requirements.txt
├── .env.example
└── README.md


## Herramientas disponibles

### search_youtube

Busca una canción en YouTube.

**Parámetros:**
- `query` (string, requerido): Nombre de la canción o artista
- `max_results` (integer, opcional): Número máximo de resultados (default: 5)
- `play` (boolean, opcional): Si es true, abre el primer resultado en el navegador

**Ejemplo:**```json
{
  "query": "Bohemian Rhapsody Queen",
  "max_results": 5,
  "play": false
}

play_youtube

Reproduce una canción en YouTube abriendo el enlace del video en el navegador.

Parámetros:
- url (string, requerido): Enlace de YouTube del video a reproducir

Ejemplo:```json
{
"url": "https://www.youtube.com/watch?v=<VIDEO_ID>"
}


También puedes pasar URLs de playlist o Mix:```json
{
  &quot;url&quot;: &quot;https://www.youtube.com/watch?v=VIDEO1&amp;playlist=VIDEO2,VIDEO3,VIDEO4&amp;autoplay=1&quot;
}
``````json
{
  &quot;url&quot;: &quot;https://www.youtube.com/watch?v=VIDEO_ID&amp;list=RDVIDEO_ID&amp;autoplay=1&quot;
}

Ejemplos de Prompts

A continuación tienes ejemplos prácticos para pedir búsquedas, listas/colas y reproducción en bucle o continua. Puedes combinarlos y ser específico con el orden, el artista y la cantidad.

  • Reproducción directa (tema suelto):
  • "Pon King Kong de Midas Alonso"
  • "Reproduce Bohemian Rhapsody de Queen y súbelo a 1080p si hay opción"

  • Reproducción en bucle o continua:

  • "Déjalo en bucle" (el agente puede activar el modo loop del reproductor o usar el Mix de YouTube cuando corresponda)
  • "Activa el Mix de YouTube de esta canción para que siga solo"
  • "Ponlo en repetición por 30 minutos"

  • Listas/colas personalizadas (orden explícito):

  • "Prepárame una cola con BRIXTON, GRAND PRIX, CLUEDO y TYRION de Midas Alonso en ese orden y reprodúcela"
  • "Crea una playlist de 8 temas de Yung Beef empezando por Me Perdí en Madrid y mezclando con artistas similares"

  • Búsquedas versátiles y por criterios:

  • "Busca 5 temas de PXXR GVNG y pon el mejor resultado oficial"
  • "Haz una playlist de 10 temas de rap español 2015–2018 y reprodúcela"
  • "Mezcla clásicos de Yung Beef con temas nuevos y activa autoplay"

Notas:
- Para reproducción en bucle exacta de un único tema, el agente puede usar el modo loop del reproductor en tu navegador. Si no está disponible, intentará alternativas como el Mix o repetir la pista al finalizar.
- Para colas dinámicas, el agente puede crear una playlist temporal en YouTube y abrirla con autoplay.

Requisitos de API Key

La API Key necesita las siguientes APIs habilitadas:
- YouTube Data API v3

Soporte de sistemas operativos

  • ✅ Windows
  • ✅ macOS
  • ✅ Linux

Licencia

Archivo LICENCE

Contribuciones

Ver archivo CONTRIBUTING.md

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Youtube MCP 8cbced6e 怎么安装?

在客户端按下面的安装命令接入:python -m venv venv。装完在客户端配置里引用同一个包或端点。

Youtube MCP 8cbced6e 怎么在 VS Code 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Youtube MCP 8cbced6e 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Youtube MCP 8cbced6e 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Youtube MCP 8cbced6e 支持哪些客户端?

资料标注支持 VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Youtube MCP 8cbced6e 能提供哪些能力?

资料显示约 2 个工具;能力标签包括 多平台支持、Python、VS Code。具体工具清单以官方文档为准。

Youtube MCP 8cbced6e 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Youtube MCP 8cbced6e 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。