YouTube Transcript MCP

Baixe transcrições diretamente de vídeos do YouTube.

Documentação

YouTube Transcript Server

Um servidor Model Context Protocol que permite a recuperação de transcrições de vídeos do YouTube. Este servidor fornece acesso direto a legendas e subtítulos de vídeos por meio de uma interface simples.

Instalando via Smithery

Para instalar o YouTube Transcript Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @kimtaeyoon83/mcp-server-youtube-transcript --client claude

Componentes

Ferramentas

get_transcript
- Extrai transcrições de vídeos do YouTube
- Entradas:
  - url (string, obrigatório): URL do vídeo do YouTube, URL de Shorts ou ID do vídeo
  - lang (string, opcional, padrão: "en"): Código de idioma para a transcrição (ex.: 'ko', 'en'). Faz fallback automaticamente para idiomas disponíveis se o idioma solicitado não for encontrado.
  - include_timestamps (booleano, opcional, padrão: false): Incluir carimbos de data/hora na saída (ex.: '[0:05] texto')
  - strip_ads (booleano, opcional, padrão: true): Filtrar patrocínios, anúncios e conteúdo promocional da transcrição com base nos marcadores de capítulo
analyze_video (opcional, requer uma chave de API do TwelveLabs)
- Analisa um vídeo com TwelveLabs Pegasus, um modelo de compreensão de vídeo. Ao contrário de get_transcript, ele raciocina sobre o que é mostrado na tela, portanto produz resumos e respostas úteis mesmo para vídeos com pouco ou nenhum discurso (demonstrações, gameplay, b-roll, videoclipes).
- Entradas:
  - url (string, obrigatório): Uma URL de vídeo direta publicamente acessível (ex.: um link .mp4/.mov/.webm ou uma URL pré-assinada). O TwelveLabs busca o arquivo no lado do servidor, portanto uma URL de página de visualização do YouTube não funcionará — ela serve HTML, não um fluxo de vídeo bruto.
  - prompt (string, opcional): Instrução ou pergunta para o modelo (ex.: "Summarize this video in 3 sentences" ou "What products are shown?"). O padrão é um resumo geral.
  - model (string, opcional, padrão: "pegasus1.2"): Modelo Pegasus a ser usado ("pegasus1.2" ou "pegasus1.5").
  - max_tokens (número, opcional, padrão: 2048): Comprimento máximo da resposta em tokens.
- Requer a variável de ambiente TWELVELABS_API_KEY. A ferramenta de transcrição funciona sem ela; a análise é totalmente opcional. Obtenha uma chave gratuita em twelvelabs.io — há um generoso plano gratuito.

Principais Recursos

Suporte a múltiplos formatos de URL de vídeo (incluindo YouTube Shorts)
Recuperação de transcrição específica por idioma com fallback automático
Carimbos de data/hora opcionais para referenciar momentos específicos
Filtro integrado de anúncios/patrocínios (habilitado por padrão)
Zero dependências externas para busca de transcrições
Metadados detalhados nas respostas

Configuração

Para usar com o Claude Desktop, adicione esta configuração de servidor:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
    }
  }
}

Para habilitar a ferramenta opcional analyze_video, adicione sua chave de API do TwelveLabs:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"],
      "env": {
        "TWELVELABS_API_KEY": "your-twelvelabs-api-key"
      }
    }
  }
}

Instalar via ferramenta

mcp-get Uma ferramenta de linha de comando para instalar e gerenciar servidores Model Context Protocol (MCP).

npx @michaellatman/mcp-get@latest install @kimtaeyoon83/mcp-server-youtube-transcript

Awesome-mcp-servers

awesome-mcp-servers Uma lista selecionada de servidores Model Context Protocol (MCP) incríveis.

Desenvolvimento

Pré-requisitos

Node.js 18 ou superior
npm ou yarn

Configuração

Instale as dependências:

npm install

Compile o servidor:

npm run build

Para desenvolvimento com recompilação automática:

npm run watch

Testes

npm test

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o MCP Inspector para desenvolvimento:

npm run inspector

Executando avaliações

O pacote de avaliações carrega um cliente mcp que então executa o arquivo index.ts, portanto não há necessidade de recompilar entre os testes. Você pode carregar variáveis de ambiente prefixando o comando npx. A documentação completa pode ser encontrada aqui.

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

Tratamento de Erros

O servidor implementa tratamento robusto de erros para cenários comuns:

URLs ou IDs de vídeo inválidos
Transcrições indisponíveis
Problemas de disponibilidade de idioma
Erros de rede

Exemplos de Uso

Obter transcrição por URL do vídeo:

await server.callTool("get_transcript", {
  url: "https://www.youtube.com/watch?v=VIDEO_ID",
  lang: "en"
});

Obter transcrição por ID do vídeo:

await server.callTool("get_transcript", {
  url: "VIDEO_ID",
  lang: "ko"
});

Obter transcrição de YouTube Shorts:

await server.callTool("get_transcript", {
  url: "https://www.youtube.com/shorts/VIDEO_ID"
});

Obter transcrição com carimbos de data/hora:

await server.callTool("get_transcript", {
  url: "VIDEO_ID",
  include_timestamps: true
});

Obter transcrição bruta sem filtro de anúncios:

await server.callTool("get_transcript", {
  url: "VIDEO_ID",
  strip_ads: false
});

Como extrair legendas do YouTube no aplicativo Claude Desktop

chat: https://youtu.be/ODaHJzOyVCQ?si=aXkJgso96Deri0aB Extract subtitles

Considerações de Segurança

O servidor:

Valida todos os parâmetros de entrada
Trata erros da API do YouTube de forma graciosa
Implementa timeouts para recuperação de transcrições
Fornece mensagens de erro detalhadas para solução de problemas

Licença

Este servidor MCP é licenciado sob a Licença MIT. Consulte o arquivo LICENSE para obter detalhes.