Paquete npm tube-search-mcp
El paquete tube-search-mcp es un proxy ligero de stdio a HTTP que conecta tu cliente de IA local al servidor MCP de Tube Search. No requiere configuración de servidor.
Cómo funciona
Cliente IA ←(stdio)→ tube-search-mcp ←(HTTP)→ tube.archivarix.net/mcpEl paquete lee mensajes MCP de stdin, los reenvía al servidor remoto de Tube Search mediante Streamable HTTP y escribe las respuestas en stdout. Tu cliente de IA cree que se comunica con un servidor MCP local.
Instalación
No necesitas instalar nada — ejecuta directamente con npx:
npx tube-search-mcp --api-key tsk_TU_CLAVEO instala globalmente:
npm install -g tube-search-mcpPaquete npm: npmjs.com/package/tube-search-mcp
Configuración
Consulta la guía de inicio rápido para ejemplos completos de configuración para cada cliente.
Opciones de CLI
| Opción | Descripción | Predeterminado |
|---|---|---|
--api-key <key> | Clave API (tsk_...) | Variable TUBE_API_KEY |
--url <url> | Endpoint MCP personalizado | https://tube.archivarix.net/mcp |
--help | Mostrar ayuda | — |
--version | Mostrar versión | — |
Variables de entorno
| Variable | Descripción |
|---|---|
TUBE_API_KEY | Clave API (obligatoria si no se proporciona --api-key) |
TUBE_MCP_URL | Reemplazar la URL del endpoint MCP predeterminada |
¿Cuándo usar el paquete npm o Remote URL?
Claude Desktop y Claude Code admiten ambos métodos:
- Paquete npm (stdio) — funciona con todos los clientes MCP, sin problemas de firewall
- Remote URL — no requiere npm/Node.js, ligeramente menos latencia, solo compatible con Claude Desktop y Claude Code
Para Cursor y VS Code, el paquete npm es la única opción.
Solución de problemas
Error: "TUBE_API_KEY environment variable is required"
Asegúrate de haber configurado TUBE_API_KEY en la configuración del entorno de tu cliente o pásala mediante --api-key.
Tiempo de conexión agotado
Verifica que tienes conexión a internet. El paquete necesita acceder a tube.archivarix.net.
Error de autenticación
Comprueba que tu clave API es válida en Perfil → API. Si la regeneraste, actualiza la clave en la configuración de tu cliente.
La primera ejecución es lenta
La primera ejecución con npx descarga el paquete. Las ejecuciones posteriores usan la versión en caché.