mcp
Référence des outils
Référence complète des 11 outils MCP exposés par le serveur Clarity.
Le serveur MCP de Clarity expose 11 outils organisés en quatre catégories. Voici chaque outil, ses paramètres et quand l'utiliser.
Outils de projets et fichiers
list_projects
Lister tous les projets de votre espace de travail Clarity.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| (aucun) | — | — | Aucun paramètre |
list_files
Lister tous les fichiers d'un projet.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
project_id | string | Oui | L'identifiant du projet |
read_file
Lire le contenu complet d'un fichier.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
file_id | string | Oui | L'identifiant du fichier à lire |
write_file
Mettre à jour le contenu d'un fichier existant.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
file_id | string | Oui | L'identifiant du fichier à mettre à jour |
content | string | Oui | Le nouveau contenu du fichier |
Cela écrase l'intégralité du fichier. Lisez toujours le fichier d'abord, puis envoyez le contenu mis à jour complet.
create_file
Créer un nouveau fichier dans un projet.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
project_id | string | Oui | Le projet |
name | string | Oui | Nom du fichier avec extension |
content | string | Non | Contenu initial |
parent_id | string | Non | Identifiant du dossier parent |
delete_file
Supprimer un fichier d'un projet.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
file_id | string | Oui | L'identifiant du fichier à supprimer |
La suppression est permanente. Utilisez avec précaution.
Compilation et débogage
compile
Compiler un projet et renvoyer le résultat.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
project_id | string | Oui | L'identifiant du projet |
debug_compile
Compiler et renvoyer une analyse structurée des erreurs.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
project_id | string | Oui | L'identifiant du projet |
Documentation Typst
typst_docs_search
Rechercher dans la bibliothèque de documentation Typst intégrée.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
query | string | Oui | Requête de recherche |
Utilisez cet outil AVANT d'écrire du code Typst.
typst_docs_read
Lire un fichier de documentation Typst spécifique.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
path | string | Oui | Le relativePath issu d'un résultat de recherche |
Illustration TikZ
tikz_illustrate
Générer des illustrations TikZ professionnelles.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
project_id | string | Oui | L'identifiant du projet |
description | string | Oui | Ce qu'il faut illustrer |
file_name | string | Non | Nom du fichier pour la figure |
Capacités :
- Organigrammes et diagrammes de processus
- Architectures de réseaux de neurones
- Tracés mathématiques (via pgfplots)
- Diagrammes commutatifs (via tikz-cd)
- Diagrammes de Feynman (via tikz-feynman)
- Structures arborescentes et hiérarchies
Flux de travail typiques
Modifier et compiler
- 1
list_projects→ trouver le projet - 2
list_files→ explorer la structure - 3
read_file→ lire le fichier cible - 4
write_file→ appliquer les modifications - 5
compile→ vérifier la compilation
Déboguer une compilation échouée
- 1
debug_compile→ obtenir une analyse structurée des erreurs - 2
read_file→ lire le fichier contenant les erreurs - 3
write_file→ corriger les problèmes - 4
compile→ confirmer la correction
Vous pouvez faire tout cela en une seule requête : « Crée un nouveau fichier de chapitre appelé methodology.tex, ajoute un organigramme TikZ, inclus-le dans main.tex et compile. »