YouTube

Um servidor MCP para interagir com os dados e serviços do YouTube.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP do YouTube

Servidor MCP do YouTube

Sobre

O servidor é uma ponte entre a API do YouTube e os assistentes de IA e é baseado no Model Context Protocol.

O que é MCP?

O Model Context Protocol (MCP) é um sistema que permite que aplicativos de IA, como o Claude Desktop, se conectem a ferramentas externas e fontes de dados. Ele fornece uma maneira clara e segura para assistentes de IA trabalharem com serviços locais e APIs, mantendo o usuário no controle.

O que este servidor faz?

Baixar legendas ocultas para o vídeo informado

Casos de uso práticos

Criar um resumo do vídeo

Pré-requisitos

Ferramenta uv

Instalação

uv tool install git+https://github.com/sparfenyuk/mcp-youtube

[!NOTE] Se você já instalou o servidor, pode atualizá-lo usando o comando uv tool upgrade --reinstall.

[!NOTE] Se você quiser excluir o servidor, use o comando uv tool uninstall mcp-youtube.

Configuração

Configuração do Claude Desktop

Configure o Claude Desktop para reconhecer o servidor MCP do YouTube.

Abra o arquivo de configuração do Claude Desktop:
- no MacOS, o arquivo de configuração está localizado em ~/Library/Application Support/Claude/claude_desktop_config.json
- no Windows, o arquivo de configuração está localizado em %APPDATA%\Claude\claude_desktop_config.json
Nota: Você também pode encontrar claude_desktop_config.json nas configurações do aplicativo Claude Desktop

Adicione a configuração do servidor

{
  "mcpServers": {
    "mcp-youtube": {
        "command": "mcp-youtube",
      }
    }
  }
}

Desenvolvimento

Começando

Clone o repositório
Instale as dependências
```
uv sync
```
Execute o servidor
```
uv run mcp-youtube --help
```

Ferramentas podem ser adicionadas ao arquivo src/mcp_youtube/tools.py.

Como adicionar uma nova ferramenta:

Crie uma nova classe que herde de ToolArgs
```
class NewTool(ToolArgs):
    """Description of the new tool."""
    pass
```
Os atributos da classe serão usados como argumentos para a ferramenta. O docstring da classe será usado como a descrição da ferramenta.
Implemente a função tool_runner para a nova classe
```
@tool_runner.register
async def new_tool(args: NewTool) -> t.Sequence[TextContent | ImageContent | EmbeddedResource]:
    pass
```
A função deve retornar uma sequência de TextContent, ImageContent ou EmbeddedResource. A função deve ser assíncrona e aceitar um único argumento da nova classe.
Pronto! Reinicie o cliente e a nova ferramenta estará disponível.

A validação pode ser feita tanto pelo Claude Desktop quanto executando a ferramenta diretamente.

Depurando o servidor no Inspector

O inspector MCP é uma ferramenta que ajuda a depurar o servidor usando uma interface gráfica elegante. Para executá-lo, use o seguinte comando:

npx @modelcontextprotocol/inspector uv run mcp-youtube

Solução de problemas

Mensagem 'Não foi possível conectar ao servidor MCP mcp-youtube'

Se você vir a mensagem 'Não foi possível conectar ao servidor MCP mcp-youtube' no Claude Desktop, isso significa que a configuração do servidor está incorreta.

Tente o seguinte:

Use o caminho completo para o binário mcp-youtube no arquivo de configuração