convez.ai
MCP ServerIntegração & APIsIntermediário
SurajSongara

YouTube MCP Server

SurajSongara/youtube-mcp-server

Acesse YouTube, transcrições e metadados direto em agentes Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra YouTube com agentes de IA, permitindo busca de vídeos, extração de transcrições, busca dentro de transcrições e recuperação de metadados. Funciona com Python 3.12+ e usa a API YouTube Data v3, com suporte a matching fuzzy e stemming para buscas inteligentes.

Instalação

$npx convez-ai SurajSongara/youtube-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Pesquisar e analisar conteúdo de vídeos do YouTube sem sair do agente
  • Extrair e buscar informações específicas em transcrições de vídeos
  • Recuperar metadados completos (título, duração, views, likes) de vídeos
  • Automatizar análise de conteúdo multimídia com busca fuzzy em transcrições

Veredito

Integração sólida e bem-implementada com YouTube, oferecendo acesso a transcrições sem necessidade de chave API (apenas para busca/metadados). O suporte a busca fuzzy e stemming é um diferencial prático. Recomendado para quem precisa conectar agentes a conteúdo de vídeo em escala.

README

A tradução para o português deste README ainda está na fila.

YouTube Transcript MCP Server

An MCP server that lets AI agents search YouTube, fetch video transcripts, search within transcript text, and retrieve video metadata. Bridges the gap between LLMs and video content.

Tools

ToolDescriptionAPI Key
search_videosSearch YouTube for videos with filtering and paginationRequired
get_metadataRetrieve video metadata: title, description, duration, view count, like count, tagsRequired
get_transcriptFetch full transcript of a video by URL or IDNone needed
search_transcriptSearch within a video's transcript for specific terms or phrasesNone needed

search_transcript supports fuzzy + stem-aware matching (no external dependencies) — catches typos and variant word forms like "coding" matching "code", "codes", "coder".

Tech Stack

Getting Started

git clone https://github.com/SurajSongara/youtube-mcp-server
cd youtube-mcp-server
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
echo "YOUTUBE_API_KEY=your_key_here" > .env
python -m src.server

A YouTube Data API key is free from Google Cloud Console (enable YouTube Data API v3). Only search_videos and get_metadata require it; transcript tools work without any key.

MCP Client Config

Add to ~/.config/opencode/opencode.jsonc or opencode.json:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "python",
      "args": ["-m", "src.server"],
      "env": {
        "YOUTUBE_API_KEY": "your_key_here"
      }
    }
  }
}

Project Structure

src/
├── server.py           # FastMCP server (all 4 tools)
└── utils/
    └── youtube_api.py  # YouTube Data API v3 client

Author

Suraj Songara

License

MIT

Ver o original no GitHub

Bom para

Relacionados