Installation

Démarrez avec Distill en moins d'une minute.

Démarrage rapide

npm install -g distill-mcp
distill-mcp setup

La commande setup détecte Claude Code et l'enregistre comme client MCP. C'est tout.

Prérequis

Node.js 20+
Claude Code installé (npm install -g @anthropic-ai/claude-code ou télécharger)

Sans installation globale

Si vous préférez ne rien installer globalement, utilisez npx :

npx distill-mcp serve

Puis ajoutez l'entrée MCP à votre configuration Claude Code (voir section suivante).

Configuration manuelle de Claude Code

Si distill-mcp setup n'a pas fonctionné ou si vous préférez éditer le fichier à la main.

Via la CLI Claude Code

claude mcp add distill -- npx distill-mcp serve

Via le fichier de configuration

Éditez ~/.claude.json (global) ou .mcp.json (par projet) :

{
  "mcpServers": {
    "distill": {
      "command": "distill-mcp",
      "args": ["serve"]
    }
  }
}

Ou avec npx (sans installation globale) :

{
  "mcpServers": {
    "distill": {
      "command": "npx",
      "args": ["distill-mcp", "serve"]
    }
  }
}

Vérifier l'installation

distill-mcp doctor

Puis redémarrez Claude Code et demandez : « Utilise auto_optimize pour compresser ce build output ».

Référence CLI

Binaire : distill-mcp. Quatre commandes.

distill-mcp serve      # Démarre le serveur MCP sur le transport stdio
distill-mcp setup      # Configure Claude Code et installe hooks/agents
distill-mcp doctor     # Diagnostique l'installation
distill-mcp analyze    # Analyse l'utilisation des tokens dans un codebase
distill-mcp --help     # Affiche toutes les options
distill-mcp --version  # Affiche la version installée

`distill-mcp serve`

Flag	Effet
`--verbose`	Active les logs détaillés sur stderr (stdout reste le canal MCP)

`distill-mcp setup`

Sans flag, setup configure Claude Code par défaut et installe tout ce qui est nécessaire. Les flags ci-dessous activent des extensions opt-in introduites en v0.10.0 :

Flag	Effet
`--hooks`	Installe le hook de pré-commit dans le projet courant
`--install-precompact-hook`	Ajoute le hook PreCompact dans `~/.claude/settings.json` (idempotent, atomique via tempfile + rename)
`--uninstall-precompact-hook`	Retire proprement l'entrée PreCompact
`--install-agent`	Copie le template `distill-compressor.md` dans `~/.claude/agents/`
`--uninstall-agent`	Supprime l'agent installé

Options transverses :

Flag	Effet
`--dry-run`	Affiche les changements sans modifier le filesystem
`--user-dir=<chemin>`	Surcharge `HOME` pour localiser `settings.json` (utile en tests)
`--force`, `-f`	Écrase une configuration existante même si elle diffère du template

`distill-mcp doctor`

Aucun flag. Vérifie la version Node, la présence de distill-mcp, la configuration Claude Code détectée et l'état des hooks installés.

`distill-mcp analyze`

Flag	Effet
`--patterns`, `-p`	Patterns glob à scanner (défaut `*/.{ts,tsx,js,jsx,py,go,rs}`)
`--threshold`, `-t`	Seuil d'alerte en tokens (défaut `2000`)
`--json`, `-j`	Sortie JSON au lieu du rapport texte
`--output`, `-o`	Écrit le rapport dans un fichier au lieu de stdout

Étapes suivantes

Référence des outils MCP — Les 3 outils : auto_optimize, smart_file_read, code_execute
Guide Claude Code — Intégration complète
Dépannage — Problèmes courants et solutions

Installation

On this page