Optimiser la recherche Claude Code avec Semble MCP — Réduction de 98% des tokens expliquée
Qu'est-ce que Semble MCP ?
Semble MCP est un serveur de recherche de code local ultra-rapide conçu spécifiquement pour les agents de codage IA. Il est conçu pour donner aux agents comme Claude Code, Cursor et OpenAI Codex une façon plus intelligente d'explorer le code — plus intelligente que grep, plus légère que RAG.
Les agents IA typiques recherchent du code en utilisant un mélange de grep, ripgrep, lectures complètes de fichiers et embeddings. Semble remplace tout cela par une approche dédiée.
"Où se trouve la logique d'authentification ?"
"Implémentation de save_model"
"Initialisation de Firebase"
Ces requêtes en langage naturel ne retournent que les extraits de code pertinents, rapidement.
Fonctionnalités clés
Traitement local ultra-rapide
Semble fonctionne uniquement sur CPU — aucun GPU requis.
- Génération d'index du dépôt : ~250ms
- Recherche : ~1,5ms
Réduction drastique des tokens
Par rapport aux workflows "grep + lecture de fichier", Semble utilise environ 98% moins de tokens pour trouver le code dont vous avez besoin. Pour les longues sessions ou les grands projets avec Claude Code, cela se traduit par des économies significatives.
Sécurité : entièrement local par conception
La documentation officielle souligne :
- Aucune clé API requise
- Aucune communication réseau externe
- Fonctionne entièrement sur des chemins locaux
La génération d'index, la recherche, la création d'embeddings et la recherche BM25 se déroulent toutes sur votre machine locale.
Configuration avec Claude Code
Vous aurez besoin de uv. Ajoutez Semble avec cette commande :
claude mcp add semble -s user -- uvx --from "semble[mcp]" semble
Le package est récupéré depuis PyPI lors de l'installation, mais toutes les opérations suivantes s'exécutent localement.
Combinaison avec les sous-agents
En plus de la version MCP, Semble dispose également d'une version CLI. Étant donné que les sous-agents Claude Code ne peuvent pas toujours utiliser MCP, il est recommandé de référencer explicitement la version CLI dans votre CLAUDE.md ou AGENTS.md :
Utilisez `semble search` au lieu de grep pour l'exploration du code source.
Cela garantit que tous les agents utilisent Semble de manière cohérente dans votre workflow.
Comment l'utiliser
# Recherche en langage naturel
semble search "authentication flow" ./my-project
semble search "Firebase initialization" ./my-project
semble search "form submission handler" ./my-project --top-k 10
# Trouver du code connexe (spécifier le chemin de fichier et le numéro de ligne)
semble find-related src/auth.py 42 ./my-project
Séparation des rôles avec les autres outils
Semble est un spécialiste de la recherche de code. Il est important de comprendre comment il s'intègre aux autres outils MCP :
| Outil | Rôle |
|---|---|
| Semble | Recherche dans votre propre code source |
| context7 | Récupère la documentation officielle des bibliothèques |
| filesystem MCP | Lire et écrire des fichiers |
| git MCP | Interagir avec Git |
En pratique :
- context7 → "Quelle est l'API officielle de Jetpack Compose ?"
- Semble → "Trouver du code Compose dans mon projet"
La compilation, le linting, l'exécution des tests et les opérations de base de données sont en dehors du périmètre de Semble.
Qui en bénéficie le plus
Cas d'utilisation à fort impact
- Grands dépôts
- Projets Android (Jetpack Compose, Firebase, configurations multi-modules)
- Workflows utilisant AGENTS.md avec de nombreux sous-agents
- Utilisation longue durée et continue de Claude Code
Cas d'utilisation moins prioritaires
- Petits dépôts (quelques fichiers seulement)
- Tâches ponctuelles
Considérations de sécurité
Bien que Semble soit entièrement local, il y a quelques points à garder à l'esprit.
Les résultats de recherche sont transmis au LLM
Semble n'envoie pas votre code à l'extérieur — mais les résultats de recherche qu'il retourne sont transmis à Claude Code, puis au LLM.
Code local
↓ Recherche Semble (locale uniquement)
↓ Résultats transmis à Claude
↓ Traitement par le LLM
Le problème n'est donc pas Semble lui-même — c'est le LLM qui reçoit votre code.
Exemple de configuration sécurisée
Si la sécurité est une priorité, limitez les MCP avec communication externe :
Claude Code
├ Semble (local)
├ filesystem MCP (local)
├ git MCP (local)
└ terminal (local)
Si vous travaillez avec du code sensible ou propriétaire, vérifier les politiques de télémétrie et de conservation des conversations du LLM est plus important que la conception de Semble elle-même.
Résumé
Semble MCP est un outil à haute valeur pour les ingénieurs qui utilisent sérieusement Claude Code.
- Jusqu'à 98% de réduction du coût en tokens
- Recherche de code en langage naturel
- Entièrement local et sécurisé
- Encore plus puissant combiné avec des sous-agents
Remplacer la recherche intensive de fichiers par grep avec Semble améliore significativement l'efficacité des agents. Si vous travaillez sur de grands projets ou des configurations multi-agents, cela vaut la peine de l'ajouter tôt.