Youtube MCP Server

Servidor MCP de YouTube

• Servidor MCP de YouTube
  • Acerca de
  • ¿Qué es MCP?
  • ¿Qué hace este servidor?
  • Casos de uso prácticos
  • Prerrequisitos
  • Instalación
  • Configuración
    • Configuración del escritorio de Claude
  • Desarrollo
    • Empezando
    • Depuración del servidor en el Inspector
  • Solución de problemas
    • Mensaje 'No se pudo conectar al servidor MCP mcp-youtube'

Acerca de

El servidor es un puente entre la API de YouTube y los asistentes de IA y se basa en el Protocolo de Contexto de Modelo .

¿Qué es MCP?

El Protocolo de Contexto de Modelo (MCP) es un sistema que permite que las aplicaciones de IA, como Claude Desktop, se conecten a herramientas y fuentes de datos externas. Ofrece una forma clara y segura para que los asistentes de IA trabajen con servicios y API locales, manteniendo al usuario en control.

¿Qué hace este servidor?

• [x] Descargar subtítulos para el vídeo indicado

Casos de uso prácticos

• [x] Crea un resumen del vídeo

Prerrequisitos

• herramienta uv

Instalación

[!NOTA] Si ya ha instalado el servidor, puede actualizarlo utilizando el comando uv tool upgrade --reinstall .

[!NOTA] Si desea eliminar el servidor, utilice el comando uv tool uninstall mcp-youtube .

Configuración

Configuración del escritorio de Claude

Configurar Claude Desktop para reconocer el servidor MCP de YouTube.

1. Abra el archivo de configuración de Claude Desktop:
   • En MacOS, el archivo de configuración se encuentra en ~/Library/Application Support/Claude/claude_desktop_config.json
   • En Windows, el archivo de configuración se encuentra en %APPDATA%\Claude\claude_desktop_config.json

   Nota: También puedes encontrar claude_desktop_config.json dentro de la configuración de la aplicación Claude Desktop

2. Agregar la configuración del servidor
   { "mcpServers": { "mcp-youtube": { "command": "mcp-youtube", } } } }

Desarrollo

Empezando

1. Clonar el repositorio
2. Instalar las dependencias
   uv sync
3. Ejecutar el servidor
   uv run mcp-youtube --help

Se pueden agregar herramientas al archivo src/mcp_youtube/tools.py .

Cómo agregar una nueva herramienta:

1. Crea una nueva clase que herede de ToolArgs
   class NewTool(ToolArgs): """Description of the new tool.""" pass
   Los atributos de la clase se usarán como argumentos para la herramienta. La cadena de documentación de la clase se usará como descripción de la herramienta.
2. Implementar la función tool_runner para la nueva clase
   @tool_runner.register async def new_tool(args: NewTool) -> t.Sequence[TextContent | ImageContent | EmbeddedResource]: pass
   La función debe devolver una secuencia de TextContent, ImageContent o EmbeddedResource. Debe ser asíncrona y aceptar un único argumento de la nueva clase.
3. ¡Listo! Reinicia el cliente y la nueva herramienta debería estar disponible.

La validación se puede realizar a través de Claude Desktop o ejecutando la herramienta directamente.

Depuración del servidor en el Inspector

El inspector MCP es una herramienta que ayuda a depurar el servidor mediante una interfaz de usuario sofisticada. Para ejecutarlo, use el siguiente comando:

Solución de problemas

Mensaje 'No se pudo conectar al servidor MCP mcp-youtube'

Si ve el mensaje 'No se pudo conectar al servidor MCP mcp-youtube' en Claude Desktop, significa que la configuración del servidor es incorrecta.

Pruebe lo siguiente:

• Utilice la ruta completa al binario mcp-youtube en el archivo de configuración