PathruleRiferimento degli strumenti MCP
Esplora gli strumenti MCP di Pathrule per runtime e scopo, inclusi gli strumenti di workflow locali e il catalogo Remote MCP nativo del Cloud, più ristretto.
In questa pagina
Questa pagina elenca gli strumenti MCP di Pathrule per capacità. L'assistente raramente ha bisogno di tutti. La maggior parte delle sessioni usa solo pathrule_get_context più una o due letture o scritture. Il server stdio locale e il Remote MCP ospitato espongono ciascuno solo le operazioni che il proprio runtime è effettivamente in grado di eseguire.
Per il modello sottostante, consulta la panoramica di MCP.
Contesto e individuazione
| Strumento | Scopo |
|---|---|
pathrule_get_context | Il punto di ingresso principale. Risolve la directory di lavoro corrente in un nodo del workspace e restituisce la porzione giusta di memorie, regole e skill per l'attività. |
pathrule_get_tree | Restituisce l'albero dei nodi del workspace (cartelle, file, contesti). Utile per i prompt di esplorazione. |
pathrule_get_node | Recupera un singolo nodo insieme alle memorie, regole e skill associate. |
pathrule_resolve | Associa un titolo o un nome noto a un id, un percorso e un riferimento di versione senza percorrere l'albero. Se la corrispondenza è univoca, può includere il contenuto nella stessa chiamata. Stdio locale. |
pathrule_read | Legge in blocco id di memorie, regole e skill in un unico round trip, fino al limite del server. Stdio locale. |
pathrule_goto | Risolve in modo approssimato un nome o un percorso in un id di nodo. Utile quando l'utente indica la destinazione in modo vago. |
pathrule_knowledge_map | Una mappa in sola lettura delle memorie, regole e skill del workspace, raggruppate in aree correlate: l'intero workspace a colpo d'occhio, gli elementi e i problemi di una singola area, oppure cos'altro è collegato a determinati elementi, file o a una query. Utile prima di una revisione della qualità o prima di aggiornare la conoscenza. |
pathrule_ping | Controllo di stato. Restituisce la directory di lavoro corrente così come la vede il runtime e un timestamp. |
pathrule_setup | Avvia Pathrule in un nuovo repository proponendo memorie, regole e skill iniziali che l'utente può approvare. |
La maggior parte delle sessioni inizia e finisce con pathrule_get_context. La risposta contiene la panoramica del workspace, gli id dei contenuti pertinenti e un suggerimento sullo strumento da chiamare dopo. L'assistente segue quel suggerimento invece di andare a tentativi.
Memoria
| Strumento | Scopo |
|---|---|
pathrule_list_memories | Elenca le memorie sotto un percorso con titoli e brevi anteprime. È l'indice virtuale MainMemory. |
pathrule_read_memory | Restituisce il contenuto completo di una memoria a partire dall'id, incluso il token di versione per la concorrenza ottimistica. |
pathrule_write_memory | Crea una memoria nel percorso di un nodo. I nodi mancanti lungo il percorso vengono creati automaticamente. Se la chiamata arriva via MCP, la fonte predefinita è claude. |
pathrule_update_memory | Modifica una memoria esistente: una sostituzione completa oppure una piccola modifica mirata con content_edit. move_to_path la sposta in un'altra posizione e restore: true ripristina una memoria eliminata. Passa expected_version_id così che una modifica concorrente generi un conflitto pulito. |
pathrule_delete_memory | Elimina una memoria in modo reversibile. Si può ripristinare finché non viene eliminata definitivamente. hard: true la elimina definitivamente e richiede un amministratore del workspace. |
Il flusso predefinito prevede get_context per trovare l'id della memoria pertinente, poi read_memory per il contenuto se l'assistente deve citarlo, e write_memory quando l'utente chiede di salvare qualcosa.
Regola
| Strumento | Scopo |
|---|---|
pathrule_read_rule | Restituisce il contenuto completo di una regola a partire dall'id. |
pathrule_write_rule | Crea una regola nel percorso di un nodo con un tipo di ambito (folder, file_type, project) e una priorità (high, medium, low). Può anche proporre un pattern di blocco o un controllo obbligatorio; una proposta viene salvata come proposta, un agente non può approvarla e nulla viene applicato finché una persona non l'ha approvata. |
pathrule_update_rule | Modifica una regola esistente con concorrenza ottimistica. Permette anche di spostarla in un altro percorso o di ripristinare una regola eliminata. |
pathrule_delete_rule | Elimina una regola in modo reversibile. Si può ripristinare finché non viene eliminata definitivamente. |
Le regole sono a livello di workspace e possono essere associate a più nodi. Per scrivere due volte una regola nello stesso percorso conviene usare l'aggiornamento, non la scrittura, per evitare duplicati.
Skill
| Strumento | Scopo |
|---|---|
pathrule_read_skill | Restituisce il contenuto completo del SKILL.md di una skill a partire dall'id. Per le skill github_ref restituisce lo snapshot in cache. |
pathrule_write_skill | Crea una skill nel percorso di un nodo. Accetta il SKILL.md completo, frontmatter incluso. La fonte può essere manual, template o github_ref. |
pathrule_update_skill | Modifica una skill esistente con concorrenza ottimistica. Permette anche di spostarla in un altro percorso o di ripristinare una skill eliminata. |
pathrule_delete_skill | Elimina una skill in modo reversibile. Si può ripristinare finché non viene eliminata definitivamente. |
Per il flusso di creazione, consulta Scrivere skill. L'assistente prepara prima una bozza e chiama pathrule_write_skill dopo che l'utente ne ha approvato il contenuto.
Pattern
| Strumento | Scopo |
|---|---|
pathrule_import_pattern | Mostra un'anteprima e importa un pacchetto pubblicato di memorie, regole e skill nel percorso del workspace scelto. |
pathrule_remove_pattern | Rimuove gli elementi appartenenti a un pacchetto di pattern importato in precedenza. |
Attività
| Strumento | Scopo |
|---|---|
pathrule_log_activity | Registra un record strutturato di una risposta che modifica file. Obbligatorio dopo ogni risposta che crea, modifica o elimina file. Campi: domain, action, scope, subjects, files_touched, task_summary. |
Il log delle attività alimenta l'attività recente del workspace, che l'estensione per VS Code mostra nella vista Recent Activity, e i livelli di apprendimento derivati. La granularità corretta è un record per risposta (non per file).
Apprendimento del progetto
Ciò che un agente ricava dal tuo codice, conservato insieme ai file che ha letto e condiviso con il workspace. Consulta Apprendimento del progetto.
| Strumento | Scopo |
|---|---|
pathrule_record_learning | Salva una conclusione a cui l'agente è arrivato leggendo il codice, insieme ai file che ha letto e al loro contenuto. Pathrule verifica quei file su disco prima di accettarla. Una conclusione non è una memoria, una regola o una skill; arriva all'agente di ogni membro come consiglio da verificare, nel contesto richiesto dall'agente, finché le sue fonti restano invariate in quel checkout. Non viene mai promossa automaticamente a regola. Passa l'id di una conclusione precedente per sostituirla con una versione corretta. |
pathrule_review_learning | Elenca le conclusioni attuali, obsolete e in conflitto, comprese quelle escluse dal contesto, e ritira una conclusione a partire dall'id. Solo la persona il cui agente ha registrato una conclusione può ritirarla, e il ritiro vale per l'intero workspace. |
pathrule_review_history | Legge le discussioni passate delle review sull'origine GitHub del repository tramite il tuo login gh esistente, così un agente può vedere come il team ha risolto in passato una questione simile. Non salva alcun commento e ignora le review di bot, di utenti esterni e quelle respinte; senza accesso a GitHub, tutto il resto continua a funzionare. |
Suggerimenti e aggiornamento
| Strumento | Scopo |
|---|---|
pathrule_list_pending_refreshes | Elenca le memorie e le regole obsolete segnalate dall'autoverifica. |
pathrule_get_refresh_brief | Prende in carico un'attività di aggiornamento e restituisce il contesto completo per la correzione, inclusi il motivo della verifica e le istruzioni per l'assistente. |
pathrule_resolve_refresh | Segna un'attività di aggiornamento come applicata o rifiutata. Chiude il flusso con intervento umano. |
pathrule_request_refresh | Segnala una memoria o una regola che l'assistente ha trovato obsoleta, contraddittoria, duplicata, troppo ristretta o poco chiara durante il lavoro normale. |
I suggerimenti sono il modo in cui Pathrule evita che l'albero dei contenuti si allontani dalla realtà. L'assistente può segnalare un problema concreto, prendere in carico un brief, proporre una correzione e chiuderla, tutto senza uscire dall'editor.
Controllo locale della scrittura lazy
Il server stdio locale espone il suo set completo di strumenti fin dal primo tools/list: letture, scritture, aggiornamenti, eliminazioni, pattern, setup, aggiornamento e attività. Non c'è niente da sbloccare prima della prima scrittura e l'elenco resta identico per tutta la sessione, così una conversazione lunga non paga mai il costo di un elenco di strumenti che cambia a metà strada.
Se preferisci iniziare ogni sessione con un elenco più ridotto, puoi attivare la modalità lazy. Imposta PATHRULE_MCP_TOOLS=lazy nell'ambiente della voce MCP di Pathrule. In modalità lazy, all'avvio sono visibili gli strumenti di lettura e pathrule_log_activity, e compare uno strumento in più:
| Strumento | Scopo |
|---|---|
pathrule_enable_writes | Solo in modalità lazy. Abilita gli strumenti di scrittura, aggiornamento, eliminazione, pattern, setup e modifica degli aggiornamenti per il resto della sessione MCP. Il server emette quindi tools/list_changed una sola volta. |
La modalità lazy non rimuove nulla; cambia solo il momento in cui gli strumenti di modifica diventano visibili. Senza la variabile, o con qualsiasi altro valore, pathrule_enable_writes non esiste perché non c'è nulla da abilitare.
Remote MCP ospitato
Remote MCP ha i propri schemi nativi del Cloud. Un'autorizzazione in lettura espone sette strumenti: pathrule_get_context, più gli strumenti di elenco e lettura per memorie, regole e skill. Un'autorizzazione in scrittura aggiunge scrittura, aggiornamento, eliminazione e cronologia per ciascun tipo, per un catalogo completo di diciannove strumenti.
| Operazione | Argomenti e comportamento in remoto |
|---|---|
| Contesto, elenchi e letture | Limitati al workspace approvato nell'autorizzazione OAuth |
| Scrittura | path, title e body, con un id di operazione stabile |
| Aggiornamento | id dell'elemento, expectedVersion numerico, title e body, con un id di operazione stabile |
| Eliminazione | Eliminazione reversibile con cronologia conservata, con l'autorizzazione in scrittura |
| Cronologia | Cronologia per elemento, con l'autorizzazione in scrittura |
Il server di autorizzazione riconosce pathrule:read, pathrule:write, pathrule:refresh e pathrule:activity. Gli scope riconosciuti non aggiungono strumenti assenti dal catalogo. Remote MCP non espone l'amministrazione dell'organizzazione, il setup del workspace, gli snapshot, l'importazione di pattern, l'apprendimento del progetto, la registrazione dell'attività né i flussi di aggiornamento. Non installa hook e non legge file locali.
Usa tools/list sul server connesso per vederne gli schemi esatti. Remote MCP tratta l'autorizzazione e il confine della distribuzione locale.
Convenzioni
Le convenzioni seguenti valgono per la superficie stdio locale. Gli schemi remoti sono descritti sopra.
- Scritture basate sul percorso. Gli strumenti di scrittura accettano un
node_pathrelativo al workspace, come/apps/apio/. Se il percorso non esiste, i nodi intermedi vengono creati automaticamente. - Concorrenza ottimistica. Gli strumenti di aggiornamento ed eliminazione accettano un
expected_version_idottenuto da una lettura precedente. In caso di mancata corrispondenza restituiscono una risposta di conflitto chiara con la versione corrente, così l'assistente può rileggere e unire le modifiche invece di sovrascrivere. - I duplicati vengono rifiutati. Una memoria il cui titolo esiste già in quel percorso, oppure una regola o una skill il cui nome esiste già nel workspace, viene rifiutata con un errore di duplicato, così l'assistente aggiorna il record esistente. Una memoria o una regola può essere forzata con
allow_duplicate: truedopo che l'assistente ha esaminato quella esistente. - Compatte per impostazione predefinita. Le risposte sono compatte per il caso comune. Sul server locale, passa
verbose: truequando ti serve il record completo. - Id stabili. Le risposte degli strumenti contengono valori
ideversion_idstabili. L'assistente può usarli nelle chiamate successive senza rileggere l'elemento padre.
Cosa leggere dopo
- Panoramica di MCP per il modello alla base della superficie degli strumenti.
- Come funzionano gli hook per il livello push che completa queste chiamate pull.
- Scrivere memorie, Scrivere regole, Scrivere skill per sapere cosa inserire nelle scritture.