Tavily

Serveur MCP Tavily

Le serveur MCP Tavily fournit :

• des outils de recherche, d'extraction, de cartographie et d'exploration
• Des capacités de recherche web en temps réel via l'outil tavily-search
• Une extraction intelligente de données à partir de pages web via l'outil tavily-extract
• Un puissant outil de cartographie web qui crée une carte structurée d'un site web
• Un explorateur web qui parcourt systématiquement les sites web

📚 Ressources utiles

• Tutoriel sur la combinaison de Tavily MCP avec le serveur MCP Neo4j
• Tutoriel sur l'intégration de Tavily MCP avec Cline dans VS Code

Serveur MCP distant

Connectez-vous directement au serveur MCP distant de Tavily au lieu de l'exécuter localement. Cela offre une expérience fluide sans nécessiter d'installation ou de configuration locale.

Utilisez simplement l'URL du serveur MCP distant avec votre clé API Tavily :

https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key> 

Obtenez votre clé API Tavily sur tavily.com.

Vous pouvez également transmettre votre clé API via un en-tête Authorization si le client MCP le prend en charge :

Authorization: Bearer <your-api-key>

Remarque : Lors de l'utilisation du MCP distant, vous pouvez spécifier des paramètres par défaut pour toutes les requêtes en incluant un en-tête DEFAULT_PARAMETERS contenant un objet JSON avec les valeurs par défaut souhaitées. Exemple :

{"include_images":true, "search_depth": "basic", "max_results": 10}

Connexion à Claude Code

Claude Code est l'outil CLI officiel d'Anthropic pour Claude. Vous pouvez ajouter le serveur MCP Tavily en utilisant la commande claude mcp add. Il existe deux méthodes d'authentification :

Option 1 : Clé API dans l'URL

Passez votre clé API directement dans l'URL. Remplacez <your-api-key> par votre véritable clé API Tavily :

claude mcp add --transport http tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

Option 2 : Flux d'authentification OAuth

Ajoutez le serveur sans clé API dans l'URL :

claude mcp add --transport http tavily https://mcp.tavily.com/mcp

Après l'ajout, vous devrez terminer le flux d'authentification :

1. Exécutez claude pour démarrer Claude Code
2. Tapez /mcp pour ouvrir la gestion du serveur MCP
3. Sélectionnez le serveur Tavily et terminez le processus d'authentification

Astuce : Ajoutez --scope user à l'une ou l'autre commande pour rendre le serveur MCP Tavily disponible globalement dans tous vos projets :

claude mcp add --transport http --scope user tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

Une fois configuré, vous aurez accès aux outils de recherche, d'extraction, de cartographie et d'exploration de Tavily.

Connexion à Cursor

Cliquez sur le bouton ⬆️ Ajouter à Cursor ⬆️, cela fera l'essentiel du travail pour vous, mais vous devrez toujours modifier la configuration pour ajouter votre CLÉ API. Vous pouvez obtenir une clé API Tavily ici.

Une fois que vous avez cliqué sur le bouton, vous devriez être redirigé vers Cursor ...

Étape 1

Cliquez sur le bouton d'installation

Étape 2

Vous devriez voir que le MCP est maintenant installé. Si le curseur bleu n'est pas déjà activé, activez-le manuellement. Vous devez également modifier la configuration pour inclure votre propre clé API Tavily.

Étape 3

Vous serez ensuite redirigé vers votre fichier mcp.json où vous devez ajouter your-api-key.

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx -y mcp-remote https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>",
      "env": {}
    }
  }
}

Flux OAuth du serveur MCP distant

Le serveur MCP distant Tavily prend en charge l'authentification OAuth sécurisée, vous permettant de vous connecter et de vous autoriser de manière transparente avec les clients compatibles.

Comment configurer l'authentification OAuth

A. Utilisation de MCP Inspector :

• Ouvrez MCP Inspector et cliquez sur "Open Auth Settings".
• Sélectionnez le flux OAuth et suivez ces étapes :
  1. Découverte des métadonnées
  2. Enregistrement du client
  3. Préparation de l'autorisation
  4. Demande d'autorisation et obtention du code d'autorisation
  5. Demande de jeton
  6. Authentification terminée

Une fois terminé, vous recevrez un jeton d'accès qui vous permettra d'effectuer des requêtes authentifiées en toute sécurité vers le serveur MCP distant Tavily.

B. Utilisation d'autres clients MCP (Exemple : Cursor) :

Vous pouvez configurer votre client MCP pour utiliser OAuth sans inclure votre clé API Tavily dans l'URL. Par exemple, dans votre mcp.json :

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx mcp-remote https://mcp.tavily.com/mcp",
      "env": {}
    }
  }
}

Si vous devez effacer les informations d'identification OAuth stockées et vous réauthentifier, exécutez :

rm -rf ~/.mcp-auth

Remarque :

• L'authentification OAuth est facultative. Vous pouvez toujours utiliser l'authentification par clé API à tout moment en incluant votre clé API Tavily dans le paramètre de requête URL (?tavilyApiKey=...) ou en la définissant dans l'en-tête Authorization, comme décrit ci-dessus.

Sélection de la clé API utilisée pour OAuth

Après une authentification OAuth réussie, vous pouvez contrôler quelle clé API est utilisée en la nommant mcp_auth_default :

• Si vous définissez une clé nommée mcp_auth_default dans votre compte personnel, cette clé sera utilisée pour le flux d'authentification.
• Si vous faites partie d'une équipe qui a une clé nommée mcp_auth_default, cette clé sera utilisée pour le flux d'authentification.
• Si vous avez à la fois une clé personnelle et une clé d'équipe nommées mcp_auth_default, la clé personnelle sera prioritaire.
• Si aucune clé mcp_auth_default n'est définie, la clé default de votre compte personnel sera utilisée. Si aucune clé default n'est définie, la première clé disponible sera utilisée.

MCP local

Prérequis 🔧

Avant de commencer, assurez-vous d'avoir :

• Clé API Tavily
  • Si vous n'avez pas de clé API Tavily, vous pouvez créer un compte gratuit ici
• Claude Desktop ou Cursor
• Node.js (v20 ou supérieur)
  • Vous pouvez vérifier votre installation de Node.js en exécutant :
    • node --version
• Git installé (nécessaire uniquement si vous utilisez la méthode d'installation Git)
  • Sur macOS : brew install git
  • Sur Linux :
    • Debian/Ubuntu : sudo apt install git
    • RedHat/CentOS : sudo yum install git
  • Sur Windows : Téléchargez Git pour Windows

Exécution avec NPX

npx -y tavily-mcp@latest 

Configuration des paramètres par défaut ⚙️

Vous pouvez définir des valeurs de paramètres par défaut pour l'outil tavily-search en utilisant la variable d'environnement DEFAULT_PARAMETERS. Cela vous permet de configurer le comportement de recherche par défaut sans spécifier ces paramètres dans chaque requête.

Exemple de configuration

export DEFAULT_PARAMETERS='{"include_images": true}'

Exemple d'utilisation depuis le client

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here",
        "DEFAULT_PARAMETERS": "{\"include_images\": true, \"max_results\": 15, \"search_depth\": \"advanced\"}"
      }
    }
  }
}

Identification de l'utilisateur final (facultatif)

Vous pouvez éventuellement identifier l'utilisateur final pour le compte duquel les requêtes sont effectuées en définissant la variable d'environnement TAVILY_HUMAN_ID. Lorsqu'elle est définie, Tavily MCP la transmet en tant qu'en-tête X-Human-Id à chaque appel API, permettant des analyses par utilisateur.

Ceci est entièrement facultatif — ne la définissez pas et le comportement reste inchangé.

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here",
        "TAVILY_HUMAN_ID": "your-user-id"
      }
    }
  }
}

Note sur la confidentialité : Tavily hache human_id côté serveur (SHA-256) avant le stockage, de sorte que la valeur brute n'est jamais conservée. Même ainsi, préférez les identifiants opaques (par exemple, un ID utilisateur interne) aux informations personnelles brutes comme les e-mails lorsque cela est possible.

Remerciements ✨

• Model Context Protocol pour la spécification MCP
• Anthropic pour Claude Desktop