/ Annuaire / Playground / Smithery CLI
● Officiel smithery-ai ⚡ Instantané

Smithery CLI

par smithery-ai · smithery-ai/cli

Le CLI officiel Smithery — smithery install <server> pour ajouter des MCPs à votre config client, plus un mode dev pour créer les vôtres.

Smithery héberge un registry public de serveurs MCP. Ce CLI permet d'installer/désinstaller dans votre config client, de lister les serveurs installés et de scaffolder un nouveau MCP pour publication.

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

prêt

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "smithery-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "smithery-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "smithery-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "smithery-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "smithery-cli",
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json
{
  "context_servers": {
    "smithery-cli": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@smithery/cli"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add smithery-cli -- npx -y @smithery/cli

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Smithery CLI

Installer un MCP sans éditer la config manuellement

👤 Développeurs ⏱ ~15 min intermediate

Quand l'utiliser : Vous en avez assez de fusionner manuellement les configs stdio.

Déroulement
  1. Parcourir
    smithery search <sujet>✓ Copié
    → Correspondances listées
  2. Installer
    smithery install <slug>✓ Copié
    → Config modifiée ; redémarrez le client
  3. Vérifier
    smithery list✓ Copié
    → Serveur présent

Résultat : Nouveau MCP installé sans archéologie de config.

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

smithery-cli + mcp2cli

Déboguer directement un MCP installé via Smithery

Combiner smithery-cli avec mcp2cli : déboguer directement un MCP installé via Smithery✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
CLI subcommands (voir la documentation) install / uninstall / list / dev / publish 1 appel

Coût et limites

Coût d'exécution

Quota d'API
N/A
Tokens par appel
N/A
Monétaire
Gratuit
Astuce
Épinglez les versions — les slugs nus suivent la dernière version

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Modifie vos fichiers de config client
Sortie de données : smithery.ai pour le registry
Ne jamais accorder : blindly install — review tool list first

Dépannage

Erreurs courantes et correctifs

Config non trouvée

Passez --config-path ; le CLI devine les valeurs par défaut mais elles varient par OS

Alternatives

Smithery CLI vs autres

AlternativeQuand l'utiliserCompromis
Config manuelleVous voulez un contrôle totalPlus de travail

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills