YouTube MCP Server

YouTube MCP Server

Um servidor Model Context Protocol (MCP) que fornece ferramentas para pesquisar vídeos do YouTube, recuperar transcrições e realizar busca semântica sobre o conteúdo dos vídeos.

Apoie-nos

Se você acha este projeto útil e gostaria de apoiar projetos futuros, considere nos comprar um café! Seu apoio nos ajuda a continuar construindo soluções inovadoras de IA.

Suas contribuições ajudam muito a alimentar nossa paixão por criar aplicações inteligentes e fáceis de usar.

Sumário

• YouTube MCP Server
• Recursos
• Pré-requisitos
• Instalação
• Executando o Servidor
  • 1. Método Direto
  • 2. Configurar para Claude.app
• Ferramentas Disponíveis
• Usando com Clientes MCP
  • Exemplo de Uso
• Depuração
• Contribuindo
• Licença

Recursos

• Pesquisar vídeos do YouTube sem usar a API oficial
• Recuperar transcrições de vídeos
• Armazenar informações de vídeo e transcrições em um banco de dados vetorial
• Realizar busca semântica sobre transcrições de vídeos armazenadas

Pré-requisitos

• Python 3.8+
• Chave da API Google para embeddings
• Gerenciador de pacotes uv

Instalação

1. Clone este repositório

2. Crie e ative um ambiente virtual usando uv:

uv venv
# On Windows:
.venv\Scripts\activate
# On Unix/MacOS:
source .venv/bin/activate

3. Instale as dependências usando uv:

uv pip install -r requirements.txt

4. Crie um arquivo .env com sua chave da API Google:

GOOGLE_API_KEY=your_api_key_here

Executando o Servidor

Existem duas maneiras de executar o servidor MCP:

1. Método Direto

Para iniciar o servidor MCP diretamente:

uv run python server.py

2. Configurar para Claude.app

Adicione às configurações do Claude sem usar nenhum gerenciador de pacotes, isso funciona para Windows:

"mcpServers": {
  "youtube": {
    "command": "C:\\Path\\To\\Your\\Project\\.venv\\Scripts\\python.exe",
    "args": ["C:\\Path\\To\\Your\\Project\\server.py"],
    "env": {
      "GOOGLE_API_KEY": "your_api_key_here"
    }
  }
}

Usando o gerenciador de pacotes Uv, isso funciona para Windows:

"mcpServers": {
  "youtube": {
    "command": "uv",
    "args": ["--directory", "C:\\Path\\To\\Your\\Project", "run", "server.py"],
    "env": {
      "GOOGLE_API_KEY": "your_api_key_here"
    }
  }
}

Ferramentas Disponíveis

O servidor fornece as seguintes ferramentas:

1. search-youtube: Pesquisar vídeos do YouTube com base em uma consulta

   • Parâmetros:
     • query: String de consulta de pesquisa
     • max_results: Número máximo de resultados a retornar (padrão: 5)

2. get-transcript: Obter a transcrição de um vídeo do YouTube

   • Parâmetros:
     • video_url: URL do vídeo do YouTube

3. store-video-info: Armazenar informações do vídeo e transcrição no banco de dados vetorial

   • Parâmetros:
     • video_url: URL do vídeo do YouTube
     • metadata: Metadados opcionais sobre o vídeo

4. search-transcripts: Pesquisar transcrições de vídeos armazenadas usando busca semântica

   • Parâmetros:
     • query: Consulta de pesquisa
     • limit: Número máximo de resultados a retornar (padrão: 3)

Usando com Clientes MCP

Este servidor pode ser usado com qualquer cliente compatível com MCP, como o Claude Desktop App. As ferramentas serão descobertas automaticamente e disponibilizadas ao cliente.

Exemplo de Uso

1. Inicie o servidor usando um dos métodos descritos acima
2. Abra o Claude Desktop App
3. Procure o ícone de martelo para verificar se as ferramentas do YouTube estão disponíveis
4. Agora você pode usar comandos como:
   • "Pesquisar vídeos de tutorial de Python"
   • "Obter a transcrição deste vídeo: [video_url]"
   • "Pesquisar nas transcrições de vídeos armazenadas sobre aprendizado de máquina"

Depuração

Se você encontrar algum problema:

1. Certifique-se de que sua chave da API Google está configurada corretamente no arquivo .env
2. Verifique se todas as dependências estão instaladas corretamente
3. Confirme se o servidor está em execução e ouvindo conexões
4. Procure por mensagens de erro na saída do servidor

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.