YouTube Translate MCP

YouTube Translate MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para acceder a la API de YouTube Translate, que permite obtener transcripciones, traducciones y resúmenes de videos de YouTube.

Características

• Obtener transcripciones de videos de YouTube
• Traducir transcripciones a diferentes idiomas
• Generar subtítulos en formato SRT o VTT
• Crear resúmenes del contenido de los videos
• Buscar contenido específico dentro de los videos

Instalación

Instalación mediante Smithery

Para instalar youtube-translate-mcp para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install @brianshin22/youtube-translate-mcp --client claude

Instalación manual

Este paquete requiere Python 3.12 o superior:

# Using uv (recommended)
uv pip install youtube-translate-mcp

# Using pip
pip install youtube-translate-mcp

O instalar desde el código fuente:

# Clone the repository
git clone https://github.com/yourusername/youtube-translate-mcp.git
cd youtube-translate-mcp

# Using uv (recommended)
uv pip install -e .

# Using pip
pip install -e .

Uso

Para ejecutar el servidor:

# Using stdio transport (default)
YOUTUBE_TRANSLATE_API_KEY=your_api_key youtube-translate-mcp

# Using SSE transport
YOUTUBE_TRANSLATE_API_KEY=your_api_key youtube-translate-mcp --transport sse --port 8000

Docker

También puedes ejecutar el servidor usando Docker:

# Build the Docker image
docker build -t youtube-translate-mcp .

# Run with stdio transport
docker run -e YOUTUBE_TRANSLATE_API_KEY=your_api_key youtube-translate-mcp

# Run with SSE transport
docker run -p 8000:8000 -e YOUTUBE_TRANSLATE_API_KEY=your_api_key youtube-translate-mcp --transport sse

Variables de entorno

• YOUTUBE_TRANSLATE_API_KEY: Obligatoria. Tu clave de API para acceder a la API de YouTube Translate.

Implementación con Smithery

Este paquete incluye un archivo smithery.yaml para facilitar la implementación con Smithery.

Para implementarlo, establece el parámetro de configuración YOUTUBE_TRANSLATE_API_KEY con tu clave de API de YouTube Translate.

Desarrollo

Requisitos previos

• Python 3.12+
• Docker (opcional)

Configuración

# Create and activate a virtual environment using uv (recommended)
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies using uv
uv pip install -e .

# Alternatively, with standard tools
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -e .

Pruebas con Claude Desktop

Para probar con Claude Desktop (solo macOS/Windows), deberás agregar tu servidor al archivo de configuración de Claude Desktop ubicado en ~/Library/Application Support/Claude/claude_desktop_config.json.

Método 1: Desarrollo local

Usa este método si deseas probar tu versión de desarrollo local:

{
    "mcpServers": {
        "youtube-translate": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/youtube-translate-mcp",
                "run",
                "-m", "youtube_translate_mcp"
            ],
            "env": {
              "YOUTUBE_TRANSLATE_API_KEY": "YOUR_API_KEY"
            }
        }
    }
}

Asegúrate de reemplazar /ABSOLUTE/PATH/TO/youtube-translate-mcp con la ruta real a tu directorio del proyecto.

Método 2: Pruebas basadas en Docker

Si prefieres probar usando Docker (recomendado para pruebas más reproducibles):

{
  "mcpServers": {
    "youtube-translate": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "YOUTUBE_TRANSLATE_API_KEY",
        "youtube-translate-mcp"
      ],
      "env": {
        "YOUTUBE_TRANSLATE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Reemplaza YOUR_API_KEY con tu clave real de API de YouTube Translate.

Para obtener más información sobre el uso de servidores MCP con Claude Desktop, consulta la documentación de MCP.

Depuración

• El Inspector MCP normal tiene un tiempo de espera incorporado para las llamadas de herramientas MCP, que generalmente es demasiado corto para estas llamadas de procesamiento de video (a partir del 13 de marzo de 2025). Es mejor usar Claude Desktop y revisar los registros de MCP de Claude en ~/Library/Logs/Claude/mcp-server-{asfasf}.log.
• Puedes usar tail -f {archivo-de-registro}.log para seguir mientras interactúas con Claude.

Licencia

MIT