Package npm tube-search-mcp

Le package tube-search-mcp est un proxy stdio-to-HTTP léger qui connecte votre client IA local au serveur MCP de Tube Search. Aucune configuration de serveur nécessaire.

Comment ça fonctionne

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

Le package lit les messages MCP depuis stdin, les transmet au serveur Tube Search distant via Streamable HTTP et écrit les réponses sur stdout. Votre client IA pense communiquer avec un serveur MCP local.

Installation

Aucune installation nécessaire — utilisez npx pour exécuter directement :

npx tube-search-mcp --api-key tsk_VOTRE_CLE

Ou installez globalement :

npm install -g tube-search-mcp

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

Configuration

Voir le guide de démarrage rapide pour des exemples de configuration complets pour chaque client.

Options CLI

Option	Description	Par défaut
`--api-key <key>`	Clé API (`tsk_...`)	variable `TUBE_API_KEY`
`--url <url>`	Point de terminaison MCP personnalisé	`https://tube.archivarix.net/mcp`
`--help`	Afficher l'aide	—
`--version`	Afficher la version	—

Variables d'environnement

Variable	Description
`TUBE_API_KEY`	Clé API (requise si `--api-key` non fournie)
`TUBE_MCP_URL`	Remplacer l'URL du point de terminaison MCP par défaut

Quand utiliser le package npm vs Remote URL

Claude Desktop et Claude Code prennent en charge les deux méthodes :

Package npm (stdio) — fonctionne avec tous les clients MCP, pas de problèmes de pare-feu
Remote URL — pas besoin de npm/Node.js, latence légèrement réduite, pris en charge uniquement par Claude Desktop et Claude Code

Pour Cursor et VS Code, le package npm est la seule option.

Dépannage

Erreur : "TUBE_API_KEY environment variable is required"

Assurez-vous d'avoir défini TUBE_API_KEY dans la configuration d'environnement de votre client ou de l'avoir transmise via --api-key.

Délai de connexion dépassé

Vérifiez que vous avez une connexion internet active. Le package doit pouvoir joindre tube.archivarix.net.

Échec de l'authentification

Vérifiez que votre clé API est valide dans Profil → API. Si vous l'avez régénérée, mettez à jour la clé dans la configuration de votre client.

Premier lancement lent

Le premier lancement via npx télécharge le package. Les lancements suivants utilisent la version en cache.

← Retour au guide MCP