Context Mode MCP — Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Réduction de contexte de 98 % via l'exécution d'outils en sandbox
Index SQLite FTS5 par session, résistant à la compaction
Hooks de routage automatiques (PreToolUse, PostToolUse, PreCompact, SessionStart)
12 plateformes supportées (Claude Code, Cursor, Codex, Gemini CLI, Copilot…)
Paradigme « penser en code » — faire écrire des scripts au LLM, pas traiter les données lui-même

Démo en direct

Aperçu en pratique

context-mode-mcp.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "context-mode-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "context-mode"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "context-mode-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "context-mode"
      ]
    }
  }
}

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": {
    "context-mode-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "context-mode"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "context-mode-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "context-mode"
      ]
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "context-mode-mcp",
      "command": "npx",
      "args": [
        "-y",
        "context-mode"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "context-mode-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "context-mode"
        ]
      }
    }
  }
}

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

claude mcp add context-mode-mcp -- npx -y context-mode

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

Cas d'usage

Usages concrets : Context Mode

Arrêter de gaspiller du contexte sur la sortie brute des outils

👤 Utilisateurs intensifs de Claude Code qui atteignent la compaction en milieu de session ⏱ ~15 min intermediate

Quand l'utiliser : Vous sentez que votre agent « oublie » au bout de 30 minutes et brûle des $$ en relectures.

Prérequis

Claude Code v1.0.33+ — brew upgrade claude-code ou npm update -g @anthropic-ai/claude-code

Déroulement

Installation

/plugin marketplace add mksglu/context-mode
/plugin install context-mode@context-mode✓ Copié

→ Le plugin enregistre les hooks + 6 outils sandbox
Vérification

/context-mode:ctx-doctor✓ Copié

→ All checks [x]
Utilisation normale

Effectue maintenant une grosse tâche qui ferait normalement exploser le contexte — ex. analyse tous les fichiers .log sous /var/log✓ Copié

→ ctx_execute utilisé à la place d'une lecture brute ; sortie indexée et non déversée
Vérifier les économies

/context-mode:ctx-stats✓ Copié

→ Ratio de réduction par outil rapporté

Résultat : La même tâche, dure 10 fois plus longtemps avant la compaction, et l'agent se souvient.

Pièges

D'autres MCP contournent le routage — Faites passer leurs appels d'outils via ctx_batch_execute pour une comptabilité cohérente

Combiner avec : serena

Reprendre une longue tâche sans interruption après la compaction

👤 Devs sur des sessions agent de plusieurs heures ⏱ ~5 min beginner

Quand l'utiliser : Votre tâche est trop grande pour tenir dans une seule fenêtre de contexte.

Déroulement

Démarrer avec --continue

[CLI flag] claude --continue✓ Copié

→ Le SQLite de la session précédente est chargé
Observer

De quoi t'ai-je parlé en dernier ? Quelles tâches sont en cours ?✓ Copié

→ Récapitulatif précis depuis l'index FTS5, sans hallucination

Résultat : Un flux de travail véritablement reprisable.

Pièges

Oublier --continue repart de zéro — La persistance nécessite --continue ; l'absence signifie un redémarrage délibéré

Combinaisons

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

context-mode-mcp + serena

Serena pour la navigation sémantique de code, context-mode pour garder sa sortie hors contexte

Utilise serena pour la recherche, ctx_execute pour post-traiter les résultats.✓ Copié

context-mode-mcp + playwright

La sortie de snapshot de page reste en sandbox

Prends un snapshot de la page via playwright, laisse context-mode le conserver — cherche dedans plutôt que de le déverser.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
ctx_execute	code: str (js/python)	Exécuter un script pour traiter des données ; ne sortir que ce qui est nécessaire	free
ctx_batch_execute	ops: [{tool, args}]	Encapsuler plusieurs appels d'outils via le sandbox	free
ctx_index	content: str, tags?: []	Stocker des données pour récupération ultérieure	free
ctx_search	query: str	Récupérer depuis l'index de session	free
ctx_fetch_and_index	url: str	Récupérer une URL, la garder hors contexte mais consultable	free
ctx_stats	none	Voir combien de contexte a été économisé	free

Coût et limites

Coût d'exécution

Quota d'API: Local
Tokens par appel: Réduction drastique — 98 % annoncés sur des sessions réelles
Monétaire: Gratuit (licence ELv2)
Astuce: Plus la session est longue, plus le gain est important — utilisez sur les longues tâches

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Session SQLite dans ~/.context-mode/

Sortie de données : Aucune

SQLite ne persiste entre les sessions que si vous utilisez --continue — sinon il est effacé

Dépannage

Erreurs courantes et correctifs

ctx-doctor signale des hooks manquants

Redémarrez complètement Claude Code après l'installation ; les hooks s'enregistrent au démarrage

Vérifier : Re-run /context-mode:ctx-doctor

Le sandbox refuse d'exécuter du code

Runtime Node/Python manquant. Le Doctor vous indique lequel. Installez avec brew/asdf.

La recherche ne retourne rien

Vérifiez que FTS5 est construit : sqlite3 ~/.context-mode/session.db "SELECT name FROM sqlite_master". Réinstallez si cassé.

Alternatives

Context Mode vs autres

Alternative	Quand l'utiliser	Compromis
Raw Claude Code (no plugin)	Sessions courtes qui n'atteignent jamais la compaction	Pas d'économie de contexte
claude-mem	Vous voulez la couche mémoire sans le paradigme d'outils sandbox	Compromis différent — mémoire uniquement, pas de sandbox de sortie d'outils

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills