YouTube Translate MCP

YouTube Translate MCP

Um servidor Model Context Protocol (MCP) para acessar a API YouTube Translate, permitindo obter transcrições, traduções e resumos de vídeos do YouTube.

Recursos

• Obter transcrições de vídeos do YouTube
• Traduzir transcrições para diferentes idiomas
• Gerar legendas nos formatos SRT ou VTT
• Criar resumos do conteúdo dos vídeos
• Pesquisar conteúdo específico dentro dos vídeos

Instalação

Instalando via Smithery

Para instalar o youtube-translate-mcp para o Claude Desktop automaticamente via Smithery:

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

Instalação Manual

Este pacote requer Python 3.12 ou superior:

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

# Using pip
pip install youtube-translate-mcp

Ou instale a partir do código-fonte:

# 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 executar o 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

Você também pode executar o 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

Variáveis de Ambiente

• YOUTUBE_TRANSLATE_API_KEY: Obrigatória. Sua chave de API para acessar a API YouTube Translate.

Implantação com Smithery

Este pacote inclui um arquivo smithery.yaml para facilitar a implantação com Smithery.

Para implantar, defina o parâmetro de configuração YOUTUBE_TRANSLATE_API_KEY com sua chave de API do YouTube Translate.

Desenvolvimento

Pré-requisitos

• Python 3.12+
• Docker (opcional)

Configuração

# 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 .

Testando com o Claude Desktop

Para testar com o Claude Desktop (somente macOS/Windows), você precisará adicionar seu servidor ao arquivo de configuração do Claude Desktop localizado em ~/Library/Application Support/Claude/claude_desktop_config.json.

Método 1: Desenvolvimento Local

Use este método se quiser testar sua versão de desenvolvimento 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"
            }
        }
    }
}

Certifique-se de substituir /ABSOLUTE/PATH/TO/youtube-translate-mcp pelo caminho real do diretório do seu projeto.

Método 2: Testes baseados em Docker

Se preferir testar usando Docker (recomendado para testes mais reproduzíveis):

{
  "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"
      }
    }
  }
}

Substitua YOUR_API_KEY pela sua chave real da API YouTube Translate.

Para mais informações sobre como usar servidores MCP com o Claude Desktop, consulte a documentação do MCP.

Depuração

• O MCP Inspector normal tem um tempo limite embutido para chamadas de ferramentas MCP, que geralmente é curto demais para essas chamadas de processamento de vídeo (a partir de 13 de março de 2025). É melhor usar o Claude Desktop e verificar os logs do MCP do Claude em ~/Library/Logs/Claude/mcp-server-{asfasf}.log.
• Você pode usar tail -f {log-file}.log para acompanhar enquanto interage com o Claude.

Licença

MIT