PathruleRéférence des outils MCP
Parcourez les outils MCP de Pathrule par environnement d'exécution et par usage, des outils de workflow locaux au catalogue Remote MCP, plus restreint et natif Cloud.
Sur cette page
Cette page recense les outils MCP de Pathrule par capacité. L'assistant a rarement besoin de tous. La plupart des sessions se limitent à pathrule_get_context et à une ou deux lectures ou écritures. Le serveur stdio local et le Remote MCP hébergé n'exposent chacun que les opérations que leur environnement d'exécution peut réellement effectuer.
Pour le modèle sous-jacent, consultez la présentation du MCP.
Contexte et découverte
| Outil | Rôle |
|---|---|
pathrule_get_context | Le point d'entrée principal. Fait correspondre le répertoire de travail courant à un nœud de l'espace de travail et renvoie la portion de mémoires, de règles et de skills adaptée à la tâche. |
pathrule_get_tree | Renvoie l'arborescence des nœuds de l'espace de travail (dossiers, fichiers, contextes). Pratique pour les prompts de découverte. |
pathrule_get_node | Récupère un nœud unique avec les mémoires, règles et skills qui lui sont rattachés. |
pathrule_resolve | Associe un titre ou un nom connu à un identifiant, un chemin et une référence de version sans parcourir l'arborescence. En cas de correspondance unique, le corps peut être inclus dans le même appel. Stdio local. |
pathrule_read | Lit par lot des identifiants de mémoires, de règles et de skills en un seul aller-retour, dans la limite fixée par le serveur. Stdio local. |
pathrule_goto | Résout de manière approximative un nom ou un chemin en identifiant de nœud. Pratique lorsque l'utilisateur désigne une cible de façon vague. |
pathrule_knowledge_map | Une carte en lecture seule des mémoires, règles et skills de l'espace de travail, regroupés en zones apparentées : tout l'espace de travail d'un coup d'œil, les éléments et problèmes d'une zone, ou ce qui se rattache à des éléments, des fichiers ou une requête donnés. Utile avant une passe de qualité ou avant de mettre à jour des connaissances. |
pathrule_ping | Vérification de l'état. Renvoie le répertoire de travail courant tel que le voit l'environnement d'exécution, ainsi qu'un horodatage. |
pathrule_setup | Initialise Pathrule dans un nouveau dépôt en proposant des mémoires, règles et skills de départ que l'utilisateur peut approuver. |
La plupart des sessions commencent et se terminent par pathrule_get_context. La réponse contient la vue d'ensemble de l'espace de travail, les identifiants des contenus correspondants et une indication sur l'outil à appeler ensuite. L'assistant suit cette indication plutôt que de deviner.
Mémoire
| Outil | Rôle |
|---|---|
pathrule_list_memories | Énumère les mémoires situées sous un chemin, avec leurs titres et un court aperçu. C'est l'index virtuel MainMemory. |
pathrule_read_memory | Renvoie le corps complet d'une mémoire à partir de son identifiant, y compris le token de version pour la concurrence optimiste. |
pathrule_write_memory | Crée une mémoire à un chemin de nœud. Les nœuds manquants le long du chemin sont créés automatiquement. La source vaut claude par défaut lors d'un appel via MCP. |
pathrule_update_memory | Modifie une mémoire existante : remplacement complet, ou petite modification ciblée avec content_edit. move_to_path la déplace et restore: true restaure une mémoire supprimée. Passez expected_version_id pour qu'une modification concurrente produise un conflit propre. |
pathrule_delete_memory | Supprime une mémoire de manière réversible. Elle reste restaurable tant qu'elle n'est pas supprimée définitivement. hard: true la supprime définitivement et nécessite un administrateur de l'espace de travail. |
Le flux par défaut consiste à appeler get_context pour trouver l'identifiant de la mémoire pertinente, puis read_memory pour obtenir son corps si l'assistant doit la citer, et write_memory lorsque l'utilisateur demande de consigner quelque chose.
Règle
| Outil | Rôle |
|---|---|
pathrule_read_rule | Renvoie le corps complet d'une règle à partir de son identifiant. |
pathrule_write_rule | Crée une règle à un chemin de nœud, avec un type de portée (folder, file_type, project) et une priorité (high, medium, low). Il peut aussi proposer un motif de blocage ou une vérification obligatoire ; une proposition est enregistrée en tant que proposition, un agent ne peut pas l'approuver, et rien n'est appliqué tant qu'une personne ne l'a pas approuvée. |
pathrule_update_rule | Modifie une règle existante avec concurrence optimiste. Permet aussi de la déplacer vers un autre chemin ou de restaurer une règle supprimée. |
pathrule_delete_rule | Supprime une règle de manière réversible. Elle reste restaurable tant qu'elle n'est pas supprimée définitivement. |
Les règles sont définies au niveau de l'espace de travail et peuvent être rattachées à plusieurs nœuds. Pour écrire deux fois une règle au même chemin, utilisez la mise à jour plutôt que l'écriture afin d'éviter les doublons.
Skill
| Outil | Rôle |
|---|---|
pathrule_read_skill | Renvoie le corps SKILL.md complet d'un skill à partir de son identifiant. Pour les skills github_ref, il renvoie l'instantané mis en cache. |
pathrule_write_skill | Crée un skill à un chemin de nœud. Accepte le SKILL.md complet, frontmatter compris. La source peut être manual, template ou github_ref. |
pathrule_update_skill | Modifie un skill existant avec concurrence optimiste. Permet aussi de le déplacer vers un autre chemin ou de restaurer un skill supprimé. |
pathrule_delete_skill | Supprime un skill de manière réversible. Il reste restaurable tant qu'il n'est pas supprimé définitivement. |
Pour le processus de rédaction, consultez Rédiger des skills. L'assistant rédige d'abord un brouillon et n'appelle pathrule_write_skill qu'une fois le corps approuvé par l'utilisateur.
Patterns
| Outil | Rôle |
|---|---|
pathrule_import_pattern | Prévisualise et importe un ensemble publié de mémoires, règles et skills au chemin choisi dans l'espace de travail. |
pathrule_remove_pattern | Retire les éléments appartenant à un ensemble de pattern importé précédemment. |
Activité
| Outil | Rôle |
|---|---|
pathrule_log_activity | Enregistre une trace structurée d'une réponse qui modifie des fichiers. Obligatoire après chaque réponse qui crée, modifie ou supprime des fichiers. Champs : domain, action, scope, subjects, files_touched, task_summary. |
Le journal d'activité alimente l'activité récente de l'espace de travail, que l'extension VS Code affiche dans sa vue Recent Activity, ainsi que les couches d'apprentissage dérivées. La bonne granularité est d'un enregistrement par réponse (et non par fichier).
Apprentissage du projet
Ce qu'un agent déduit de votre code, conservé avec les fichiers qu'il a lus et partagé avec l'espace de travail. Consultez Apprentissage du projet.
| Outil | Rôle |
|---|---|
pathrule_record_learning | Enregistre un constat auquel l'agent est parvenu en lisant le code, avec les fichiers qu'il a lus et leur contenu. Pathrule vérifie ces fichiers sur le disque avant de l'accepter. Un constat n'est ni une mémoire, ni une règle, ni un skill ; il parvient à l'agent de chaque membre sous forme de conseil à vérifier, dans le contexte que l'agent demande, tant que ses sources restent inchangées dans cette copie de travail. Il n'est jamais promu automatiquement en règle. Passez l'identifiant d'un constat antérieur pour le remplacer par une version corrigée. |
pathrule_review_learning | Liste les constats actuels, obsolètes et contradictoires, y compris ceux écartés du contexte, et retire un constat à partir de son identifiant. Seule la personne dont l'agent a enregistré un constat peut le retirer, et ce retrait s'applique à tout l'espace de travail. |
pathrule_review_history | Lit les discussions de revue passées sur l'origine GitHub du dépôt via votre connexion gh existante, afin qu'un agent puisse voir comment l'équipe a tranché une question similaire auparavant. Il ne stocke aucun commentaire et ignore les revues de bots, les revues externes et les revues rejetées ; sans accès à GitHub, tout le reste continue de fonctionner. |
Suggestions et actualisation
| Outil | Rôle |
|---|---|
pathrule_list_pending_refreshes | Liste les mémoires et règles obsolètes signalées par l'auto-audit. |
pathrule_get_refresh_brief | Prend en charge une tâche d'actualisation et renvoie tout le contexte de correction, y compris le motif de l'audit et les instructions destinées à l'assistant. |
pathrule_resolve_refresh | Marque une tâche d'actualisation comme appliquée ou rejetée. Clôt le workflow avec validation humaine. |
pathrule_request_refresh | Signale une mémoire ou une règle que l'assistant a jugée obsolète, contradictoire, en doublon, trop restreinte ou peu claire au cours de son travail normal. |
Les suggestions permettent à Pathrule d'éviter que l'arborescence de contenus ne dérive. L'assistant peut signaler un problème concret, prendre en charge un brief, proposer une correction et la résoudre, sans quitter l'éditeur.
Contrôle local des écritures en mode lazy
Le serveur stdio local annonce l'ensemble de ses outils dès le premier tools/list : lectures, écritures, mises à jour, suppressions, patterns, initialisation, actualisation et activité. Rien n'a besoin d'être déverrouillé avant la première écriture, et la liste reste identique pendant toute la session : une longue conversation ne paie donc jamais le coût d'une liste d'outils qui change en cours de route.
Si vous préférez démarrer chaque session avec une liste plus réduite, le mode lazy est disponible sur demande. Définissez PATHRULE_MCP_TOOLS=lazy dans l'environnement de l'entrée MCP de Pathrule. En mode lazy, les outils de lecture et pathrule_log_activity sont visibles au démarrage, et un outil supplémentaire apparaît :
| Outil | Rôle |
|---|---|
pathrule_enable_writes | Mode lazy uniquement. Active les outils d'écriture, de mise à jour, de suppression, de patterns, d'initialisation et de modification des actualisations pour le reste de la session MCP. Le serveur émet alors tools/list_changed une seule fois. |
Le mode lazy ne retire rien ; il change seulement le moment où les outils de modification deviennent visibles. Sans la variable, ou avec toute autre valeur, pathrule_enable_writes n'existe pas, puisqu'il n'y a rien à activer.
Remote MCP hébergé
Remote MCP dispose de ses propres schémas, natifs Cloud. Une autorisation en lecture expose sept outils : pathrule_get_context, ainsi que des outils de liste et de lecture pour les mémoires, les règles et les skills. Une autorisation en écriture ajoute l'écriture, la mise à jour, la suppression et l'historique pour chaque type, soit un catalogue complet de dix-neuf outils.
| Opération | Arguments et comportement à distance |
|---|---|
| Contexte, listes et lectures | Limités à l'espace de travail approuvé dans l'autorisation OAuth |
| Écriture | path, title et body, avec un identifiant d'opération stable |
| Mise à jour | id de l'élément, expectedVersion numérique, title et body, avec un identifiant d'opération stable |
| Suppression | Suppression réversible avec conservation de l'historique, sous l'autorisation en écriture |
| Historique | Historique par élément, sous l'autorisation en écriture |
Le serveur d'autorisation reconnaît pathrule:read, pathrule:write, pathrule:refresh et pathrule:activity. Les scopes reconnus n'ajoutent pas d'outils absents du catalogue. Remote MCP n'expose ni l'administration de l'organisation, ni l'initialisation de l'espace de travail, ni les instantanés, ni les imports de patterns, ni l'apprentissage du projet, ni la journalisation de l'activité, ni les workflows d'actualisation. Il n'installe aucun hook et ne lit aucun fichier local.
Utilisez tools/list sur le serveur connecté pour consulter ses schémas exacts. La page Remote MCP traite de l'autorisation et de la frontière avec la diffusion locale.
Conventions
Les conventions ci-dessous s'appliquent à la surface stdio locale. Les schémas distants sont décrits plus haut.
- Écritures guidées par le chemin. Les outils d'écriture prennent un
node_pathrelatif à l'espace de travail, comme/apps/apiou/. Si le chemin n'existe pas, les nœuds intermédiaires sont créés automatiquement. - Concurrence optimiste. Les outils de mise à jour et de suppression acceptent un
expected_version_idissu d'une lecture précédente. En cas de non-correspondance, ils renvoient une réponse de conflit explicite avec la version actuelle, afin que l'assistant puisse relire et fusionner plutôt qu'écraser. - Les doublons sont refusés. Une mémoire dont le titre existe déjà à ce chemin, ou une règle ou un skill dont le nom existe déjà dans l'espace de travail, est rejetée avec une erreur de doublon, pour que l'assistant mette plutôt à jour l'enregistrement existant. Une mémoire ou une règle peut être forcée avec
allow_duplicate: trueune fois que l'assistant a examiné l'élément existant. - Compact par défaut. Les réponses sont compactes dans le cas courant. Sur le serveur local, passez
verbose: truelorsque vous avez besoin de l'enregistrement complet. - Identifiants stables. Les réponses des outils contiennent des valeurs
idetversion_idstables. L'assistant peut y faire référence dans les appels suivants sans relire l'élément parent.
Pour aller plus loin
- Présentation du MCP pour le modèle qui sous-tend la surface d'outils.
- Fonctionnement des hooks pour la couche push qui complète ces appels en mode pull.
- Rédiger des mémoires, Rédiger des règles, Rédiger des skills pour savoir quoi mettre dans les écritures.