Pacote npm tube-search-mcp

O pacote tube-search-mcp é um proxy leve de stdio para HTTP que conecta seu cliente de IA local ao servidor MCP do Tube Search. Sem necessidade de configuração de servidor.

Como funciona

Cliente IA ←(stdio)→ tube-search-mcp ←(HTTP)→ tube.archivarix.net/mcp

O pacote lê mensagens MCP do stdin, encaminha para o servidor remoto do Tube Search via Streamable HTTP e escreve as respostas no stdout. Seu cliente de IA pensa que está se comunicando com um servidor MCP local.

Instalação

Não é necessário instalar — execute diretamente com npx:

npx tube-search-mcp --api-key tsk_SUA_CHAVE

Ou instale globalmente:

npm install -g tube-search-mcp

Pacote npm: npmjs.com/package/tube-search-mcp

Configuração

Consulte o guia de início rápido para exemplos completos de configuração para cada cliente.

Opções de CLI

Opção	Descrição	Padrão
`--api-key <key>`	Chave API (`tsk_...`)	Variável `TUBE_API_KEY`
`--url <url>`	Endpoint MCP personalizado	`https://tube.archivarix.net/mcp`
`--help`	Mostrar ajuda	—
`--version`	Mostrar versão	—

Variáveis de ambiente

Variável	Descrição
`TUBE_API_KEY`	Chave API (obrigatória se `--api-key` não for fornecida)
`TUBE_MCP_URL`	Substituir a URL padrão do endpoint MCP

Quando usar o pacote npm ou Remote URL?

O Claude Desktop e o Claude Code suportam ambos os métodos:

Pacote npm (stdio) — funciona com todos os clientes MCP, sem problemas de firewall
Remote URL — não requer npm/Node.js, latência ligeiramente menor, suportado apenas pelo Claude Desktop e Claude Code

Para o Cursor e o VS Code, o pacote npm é a única opção.

Solução de problemas

Erro: "TUBE_API_KEY environment variable is required"

Certifique-se de ter configurado TUBE_API_KEY na configuração de ambiente do seu cliente ou passe-a via --api-key.

Tempo limite de conexão

Verifique se você tem uma conexão ativa com a internet. O pacote precisa acessar tube.archivarix.net.

Falha na autenticação

Verifique se sua chave API é válida em Perfil → API. Se você a regenerou, atualize a chave na configuração do seu cliente.

Primeira execução é lenta

A primeira execução com npx baixa o pacote. As execuções seguintes usam a versão em cache.

← Voltar ao guia MCP