Perplexity MCP Server

Serveur MCP de la plateforme API Perplexity

     

L'implémentation officielle du serveur MCP pour la plateforme API Perplexity, fournissant aux assistants IA des capacités de recherche web en temps réel, de raisonnement et de recherche approfondie via les modèles Sonar et l'API Search.

Outils disponibles

perplexity_search

Recherche web directe utilisant l'API Perplexity Search. Renvoie des résultats de recherche classés avec métadonnées, parfait pour trouver des informations actuelles.

perplexity_ask

IA conversationnelle polyvalente avec recherche web en temps réel utilisant le modèle sonar-pro. Idéal pour les questions rapides et les recherches quotidiennes.

perplexity_research

Recherche approfondie et complète utilisant le modèle sonar-deep-research. Idéal pour une analyse minutieuse et des rapports détaillés.

perplexity_reason

Raisonnement avancé et résolution de problèmes utilisant le modèle sonar-reasoning-pro. Parfait pour les tâches analytiques complexes.

[!TIP] Disponible en tant que paramètre optionnel pour perplexity_reason et perplexity_research : strip_thinking

Définir sur true pour supprimer les balises <think>...</think> de la réponse, économisant ainsi des tokens de contexte. Par défaut : false

Configuration

Obtenir votre clé API

1. Obtenez votre clé API Perplexity depuis le Portail API
2. Remplacez your_key_here dans les configurations ci-dessous par votre clé API
3. (Optionnel) Définir le délai d'expiration : PERPLEXITY_TIMEOUT_MS=600000 (par défaut : 5 minutes)
4. (Optionnel) Définir une URL de base personnalisée : PERPLEXITY_BASE_URL=https://your-custom-url.com (par défaut : https://api.perplexity.ai)
5. (Optionnel) Définir le niveau de journalisation : PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR (par défaut : ERROR)

Claude Code

claude mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

Ou installer via le plugin :

export PERPLEXITY_API_KEY="your_key_here"
claude
# Then run: /plugin marketplace add perplexityai/modelcontextprotocol
# Then run: /plugin install perplexity

Codex

codex mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

Cursor, Claude Desktop, Kiro, Windsurf et VS Code

La plupart des clients peuvent être configurés manuellement en utilisant le même wrapper mcpServers dans leur configuration client (comme illustré pour Cursor). Si un client a un schéma différent, consultez sa documentation pour le format exact du wrapper.

Pour la configuration manuelle, ces clients utilisent tous la même structure mcpServers :

Client	Fichier de configuration
Cursor	~/.cursor/mcp.json
Claude Desktop	claude_desktop_config.json
Kiro	.kiro/settings/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
VS Code	.vscode/mcp.json

{
  "mcpServers": {
    "perplexity": {
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "your_key_here"
      }
    }
  }
}

Configuration du proxy (pour les réseaux d'entreprise)

Si vous exécutez ce serveur au travail — en particulier derrière un pare-feu ou un proxy d'entreprise — vous devrez peut-être indiquer au programme comment acheminer son trafic Internet via le proxy de votre réseau. Suivez ces étapes :

1. Obtenez les détails de votre proxy

• Demandez à votre service informatique l'adresse et le port de votre proxy HTTPS.
• Vous pourriez également avoir besoin d'un nom d'utilisateur et d'un mot de passe.

2. Définir la variable d'environnement du proxy

Le moyen le plus simple et le plus fiable pour Perplexity MCP est d'utiliser PERPLEXITY_PROXY. Par exemple :

export PERPLEXITY_PROXY=https://your-proxy-host:8080

Si votre proxy nécessite un nom d'utilisateur et un mot de passe, utilisez :

export PERPLEXITY_PROXY=https://username:password@your-proxy-host:8080

3. Alternative : variables d'environnement standard

Si vous préférez utiliser les variables standard, nous prenons en charge HTTPS_PROXY et HTTP_PROXY.

[!NOTE] Le serveur vérifie les paramètres de proxy dans cet ordre : PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY. Si aucun n'est défini, il se connecte directement à Internet. Les URL doivent inclure https://. Les ports typiques sont 8080, 3128 et 80.

Déploiement du serveur HTTP

Pour les déploiements cloud ou partagés, exécutez le serveur en mode HTTP.

Variables d'environnement

Variable	Description	Par défaut
PERPLEXITY_API_KEY	Votre clé API Perplexity	Requis
PERPLEXITY_BASE_URL	URL de base personnalisée pour les requêtes API	https://api.perplexity.ai
PORT	Port du serveur HTTP	8080
BIND_ADDRESS	Interface réseau à laquelle se lier. Par défaut, boucle locale. Définir sur 0.0.0.0 pour exposer sur toutes les interfaces.	127.0.0.1
ALLOWED_ORIGINS	Origines CORS (séparées par des virgules). Par défaut vide (pas de requêtes navigateur cross-origin). Définir une liste d'autorisation explicite (par ex. https://app.example.com) ou sur * pour autoriser toute origine.	(vide)
ALLOWED_HOSTS	Valeurs d'en-tête Host supplémentaires à accepter (séparées par des virgules). Les hôtes de boucle locale sur PORT sont toujours autorisés. Ajoutez le nom d'hôte public lors de la liaison à 0.0.0.0.	(boucle locale uniquement)

Docker

docker build -t perplexity-mcp-server .
docker run -p 8080:8080 -e PERPLEXITY_API_KEY=your_key_here perplexity-mcp-server

Node.js

export PERPLEXITY_API_KEY=your_key_here
npm install && npm run build && npm run start:http

Le serveur sera accessible à l'adresse http://localhost:8080/mcp

Dépannage

• Problèmes de clé API : Assurez-vous que PERPLEXITY_API_KEY est correctement défini
• Erreurs de connexion : Vérifiez votre connexion Internet et la validité de la clé API
• Outil introuvable : Assurez-vous que le package est installé et que le chemin de la commande est correct
• Erreurs de délai d'expiration : Pour les requêtes de recherche très longues, définissez PERPLEXITY_TIMEOUT_MS sur une valeur plus élevée
• Problèmes de proxy : Vérifiez votre configuration PERPLEXITY_PROXY ou HTTPS_PROXY et assurez-vous que api.perplexity.ai n'est pas bloqué par votre pare-feu.
• Erreurs EOF / d'initialisation : Certains clients MCP stricts échouent parce que npx écrit des messages d'installation sur stdout. Utilisez npx -yq au lieu de npx -y pour supprimer cette sortie.

Pour obtenir de l'aide, visitez community.perplexity.ai ou signalez un problème.

---