Intégration MCP#

Configure Semantiq avec Claude Code, Cursor, Windsurf et d'autres outils IA.

Qu'est-ce que MCP ?#

MCP (Model Context Protocol) est un standard ouvert qui permet aux assistants IA de communiquer avec des outils et services externes. Semantiq implémente MCP pour fournir une compréhension sémantique du code à tout outil compatible.

Compatibilité des outils#

Semantiq fonctionne avec tout outil IA compatible MCP. Voici des exemples de configuration pour les outils populaires :

Claude Code (CLI)#

Configuration automatique :

npx semantiq-mcp init

Ou édite manuellement .claude/settings.json :

1{
2  "mcpServers": {
3    "semantiq": {
4      "command": "npx",
5      "args": ["-y", "semantiq-mcp", "serve"]
6    }
7  }
8}

Claude Desktop#

Ajoute à claude_desktop_config.json (macOS : ~/Library/Application Support/Claude/) :

1{
2  "mcpServers": {
3    "semantiq": {
4      "command": "npx",
5      "args": ["-y", "semantiq-mcp", "serve"],
6      "cwd": "/chemin/vers/ton/projet"
7    }
8  }
9}

Cursor#

Configuration automatique :

npx semantiq-mcp init-cursor

Ou crée manuellement .cursor/mcp.json :

1{
2  "mcpServers": {
3    "semantiq": {
4      "command": "npx",
5      "args": ["-y", "semantiq-mcp", "serve"]
6    }
7  }
8}

Windsurf#

Crée .windsurf/mcp.json dans ton projet :

1{
2  "mcpServers": {
3    "semantiq": {
4      "command": "npx",
5      "args": ["-y", "semantiq-mcp", "serve"]
6    }
7  }
8}

VS Code + Continue#

Ajoute à ~/.continue/config.json :

1{
2  "experimental": {
3    "modelContextProtocolServers": [
4      {
5        "transport": {
6          "type": "stdio",
7          "command": "npx",
8          "args": ["-y", "semantiq-mcp", "serve"]
9        }
10      }
11    ]
12  }
13}

IDEs JetBrains#

Les IDEs JetBrains (2025.2+) supportent MCP nativement. Consulte la documentation JetBrains pour les instructions de configuration.

Important : Après configuration, indexe ton projet :

semantiq index .

Recherche sémantique#

Semantiq combine 4 stratégies de recherche :

Comment ça fonctionne#

1. Recherche sémantique - Utilise des embeddings (MiniLM-L6-v2) pour trouver du code conceptuellement similaire
2. Recherche lexicale - Recherche regex rapide avec ripgrep pour les correspondances exactes
3. Recherche de symboles - Recherche FTS5 des noms de fonctions/classes/variables
4. Analyse des dépendances - Parcours de graphe pour comprendre les relations du code

Par exemple, rechercher "gestionnaire d'authentification" trouvera des fonctions comme handleLogin, verifyToken ou checkAuth même si elles ne contiennent pas ces mots exacts.

Outils disponibles#

Semantiq fournit 4 outils MCP pour les assistants IA :

semantiq_search#

Recherche sémantique + lexicale combinant 4 stratégies.

1{
2  "query": "string",       // Requis : Requête de recherche
3  "limit": 20,             // Optionnel : résultats max (défaut : 20)
4  "min_score": 0.35,       // Optionnel : similarité minimum (défaut : 0.35)
5  "file_type": "string",   // Optionnel : filtrer par extension (ex : "ts")
6  "symbol_kind": "string"  // Optionnel : filtrer par type (function, class, etc.)
7}

semantiq_find_refs#

Trouve toutes les références à un symbole incluant définitions et usages.

1{
2  "symbol": "string",  // Requis : Nom du symbole à trouver
3  "limit": 50          // Optionnel : résultats max (défaut : 50)
4}

semantiq_deps#

Analyse le graphe de dépendances d'un fichier. Affiche les imports et dépendants.

{
  "file_path": "string"  // Requis : Chemin du fichier à analyser
}

semantiq_explain#

Obtient une explication détaillée d'un symbole incluant définition, documentation et patterns d'usage.

{
  "symbol": "string"  // Requis : Nom du symbole à expliquer
}

Semantiq vs grep/find#

Pour une comparaison détaillée avec grep/find, voir Semantiq vs grep/find.

Auto-indexation#

En mode serveur MCP, Semantiq surveille automatiquement les changements de fichiers et met à jour l'index en temps réel. Aucune ré-indexation manuelle nécessaire après la configuration initiale.

Dépannage#

Le serveur ne démarre pas#

Vérifie que Semantiq est correctement installé en exécutant semantiq --version dans ton terminal.

Résultats de recherche vides#

Assure-toi que ton projet est indexé. Exécute semantiq index . à la racine de ton projet. Vérifie que .semantiq.db existe.

Résultats obsolètes#

Si l'auto-indexation semble bloquée, exécute semantiq index --force pour reconstruire l'index entier.

Voir aussi#

• Référence CLI - Documentation complète des commandes
• Guide d'utilisation - Exemples pratiques pour chaque outil
• Workflow optimal - Combiner Semantiq avec les outils natifs