Semantiqv0.5.2
01Accueil
02Fonctionnalités
03Docs
04Blog
05Changelog
06Support
Commencer

Pour commencer

  • Démarrage rapideGet started in 5 minutes

Référence

  • Commandes CLICommand reference
  • Intégration MCPAI assistant setup
  • Guide d'UtilisationUsage patterns
  • Workflow OptimalDevelopment workflow
  • Semantiq vs grepvs grep & find
  • ChangelogVersion history

Loading documentation...

Semantiq

Serveur MCP écrit en Rust, parsing via Tree-sitter.

GitHub

Produit

  • Fonctionnalités
  • Documentation
  • Changelog

Ressources

  • Démarrage rapide
  • Référence CLI
  • Intégration MCP
  • Blog

Communauté

  • Support
  • GitHub
// 19 langages supportés
Rust
TypeScript
JavaScript
Python
Go
Java
C
C++
PHP
Ruby
C#
Kotlin
Scala
Bash
Elixir
HTML
JSON
YAML
TOML
© 2026 Semantiq.|v0.5.2|connecté
MIT·Construit avec Rust & Tree-sitter
  1. Home
  2. Docs
  3. Guide d'Utilisation
Guide
4 min read

Guide d'Utilisation

Comment utiliser concrètement les outils MCP Semantiq - avec des vrais exemples.

Guide d'Utilisation#

Voilà comment tirer le max des 4 outils MCP de Semantiq. On passe direct aux exemples.

semantiq_search#

L'outil principal. Trouve du code par le sens, pas juste les mots-clés.

Paramètres#

ParamTypeDéfautCe que ça fait
querystring—Ce que tu cherches
limitnumber20Nombre max de résultats
min_scorefloat0.35Seuil (0.0-1.0)
file_typestring—ex: ts,tsx,py
symbol_kindstring—function, class, interface...

En pratique#

Chercher un concept :

Plain Text
1→ semantiq_search("authentication handler")
2
3src/auth/handler.ts:23 [0.89]
4 function handleAuth(req: Request): Promise<User>
5
6src/middleware/auth.ts:45 [0.76]
7 export const authMiddleware = async (ctx) => {...}
8
9src/utils/token.ts:12 [0.71]
10 function verifyToken(token: string): boolean

Il a trouvé verifyToken alors que "authentication" n'est pas dans le nom. C'est ça le côté sémantique.

Affiner les résultats :

Plain Text
1→ semantiq_search("User", symbol_kind: "interface")
2
3src/types/user.ts:5 [0.95]
4 interface User { id: string; email: string; ... }
5
6src/types/auth.ts:12 [0.82]
7 interface UserCredentials { email: string; ... }

Quand tu veux de la précision :

Mets min_score: 0.7 ou plus. Moins de résultats, mais pile ce qu'il faut.


semantiq_explain#

Pour comprendre ce que fait un symbole sans lire tout le fichier.

Paramètres#

ParamTypeCe que ça fait
symbolstringLe truc à expliquer

En pratique#

Plain Text
1→ semantiq_explain("handleAuth")
2
3FUNCTION: handleAuth
4Location: src/auth/handler.ts:23-45
5
6async function handleAuth(
7 req: Request,
8 options?: AuthOptions
9): Promise<User>
10
11Doc: Handles user authentication by verifying
12credentials and returning the authenticated user.
13
14Related:
15 → User (return type)
16 → AuthOptions (param)
17 → verifyToken (called inside)
18 → authMiddleware (caller)

Tu récupères la signature, la doc s'il y en a, et ce qui est connecté. Sans fouiller dans le fichier.


semantiq_deps#

Montre le réseau d'imports/exports autour d'un fichier. Indispensable avant de toucher à du code partagé.

Paramètres#

ParamTypeCe que ça fait
file_pathstringFichier à analyser

En pratique#

Plain Text
1→ semantiq_deps("src/auth/handler.ts")
2
3IMPORTS (ce qu'il utilise):
4 src/types/user.ts → User, UserRole
5 src/utils/token.ts → verifyToken, generateToken
6 src/config/auth.ts → authConfig
7 src/db/users.ts → findUserByEmail
8
9DEPENDENTS (ce qui l'utilise):
10 src/middleware/auth.ts → handleAuth
11 src/routes/api.ts → handleAuth
12 src/tests/auth.test.ts → handleAuth

Pour les utilitaires centraux :

Plain Text
1→ semantiq_deps("src/utils/token.ts")
2
3IMPORTS: 2 fichiers
4DEPENDENTS: 8 fichiers
5
6⚠ Fichier à fort impact

Beaucoup de dépendants = prudence.


semantiq_find_refs#

Trouve tous les endroits où un symbole est utilisé. À utiliser avant le refactoring.

Paramètres#

ParamTypeDéfautCe que ça fait
symbolstring—Ce qu'on cherche
limitnumber50Max de refs

En pratique#

Plain Text
1→ semantiq_find_refs("handleAuth")
2
3DEFINITION
4 src/auth/handler.ts:23
5 export async function handleAuth(req: Request)
6
7USAGES
8 src/middleware/auth.ts:12
9 const user = await handleAuth(ctx.request);
10
11 src/routes/api.ts:45
12 router.post('/login', (req) => handleAuth(req));
13
14 src/tests/auth.test.ts:23
15 const result = await handleAuth(mockRequest);
16
17 src/tests/auth.test.ts:56
18 expect(handleAuth(invalidReq)).rejects.toThrow();

Contrairement à grep, ça distingue les définitions des utilisations. Zéro bruit.


Vitesse#

OutilTypiqueGros projet
semantiq_search~45ms~120ms
semantiq_explain~30ms~60ms
semantiq_deps~25ms~80ms
semantiq_find_refs~40ms~100ms

Tous les outils répondent en moins de 120ms, même sur de gros projets.


Conseils#

Sur les requêtes :

  • "authentication handler" > "auth" — sois spécifique
  • Le langage naturel marche : "function that validates user input"
  • Combine les filtres : file_type: "ts" + symbol_kind: "function"

Sur min_score :

  • 0.3 → exploration, large filet
  • 0.5-0.6 → tu cherches un truc précis
  • 0.7+ → il te faut exactement ça

Pattern de travail :

  1. semantiq_search pour trouver des candidats
  2. semantiq_explain sur les résultats intéressants
  3. semantiq_deps avant de modifier quoi que ce soit
  4. semantiq_find_refs avant de renommer

Voir aussi#

  • Référence CLI - Documentation complète des commandes
  • Workflow optimal - Combiner Semantiq avec les outils natifs
  • Semantiq vs grep/find - Comparaison détaillée des outils

Was this page helpful? Let us know on GitHub.