PathruleReferencia de herramientas MCP
Explora las herramientas MCP de Pathrule según el entorno de ejecución y el propósito, incluidas las herramientas de flujo de trabajo locales y el catálogo más acotado de Remote MCP, nativo de la nube.
En esta página
Esta página recoge las herramientas MCP de Pathrule organizadas por capacidad. El asistente rara vez necesita todas. La mayoría de las sesiones solo usan pathrule_get_context y una o dos lecturas o escrituras. El servidor stdio local y el Remote MCP alojado exponen únicamente las operaciones que su entorno de ejecución puede realizar de verdad.
Para entender el modelo subyacente, consulta la descripción general de MCP.
Contexto y descubrimiento
| Herramienta | Propósito |
|---|---|
pathrule_get_context | El punto de entrada principal. Resuelve el directorio de trabajo actual a un nodo del espacio de trabajo y devuelve la porción adecuada de memorias, reglas y skills para la tarea. |
pathrule_get_tree | Devuelve el árbol de nodos del espacio de trabajo (carpetas, archivos, contextos). Útil para prompts de descubrimiento. |
pathrule_get_node | Obtiene un solo nodo junto con sus memorias, reglas y skills asociadas. |
pathrule_resolve | Asocia un título o nombre conocido con un id, una ruta y un identificador de versión sin recorrer el árbol. Si hay una única coincidencia, puede incluir el cuerpo en la misma llamada. Stdio local. |
pathrule_read | Lee en lote ids de memorias, reglas y skills en un solo viaje de ida y vuelta, hasta el límite del servidor. Stdio local. |
pathrule_goto | Resuelve de forma aproximada un nombre o una ruta a un id de nodo. Útil cuando el usuario nombra el destino de manera imprecisa. |
pathrule_knowledge_map | Un mapa de solo lectura de las memorias, reglas y skills del espacio de trabajo, agrupadas en regiones relacionadas: todo el espacio de trabajo de un vistazo, los elementos y problemas de una región, o qué más se relaciona con determinados elementos, archivos o una consulta. Útil antes de una revisión de calidad o antes de actualizar el conocimiento. |
pathrule_ping | Comprobación de estado. Devuelve cómo ve el entorno de ejecución el directorio de trabajo actual, junto con una marca de tiempo. |
pathrule_setup | Inicializa Pathrule en un repositorio nuevo proponiendo memorias, reglas y skills iniciales que el usuario puede aprobar. |
La mayoría de las sesiones empiezan y terminan con pathrule_get_context. La respuesta incluye la descripción general del espacio de trabajo, los ids del contenido que coincide y una indicación sobre qué herramienta llamar después. El asistente sigue esa indicación en lugar de adivinar.
Memoria
| Herramienta | Propósito |
|---|---|
pathrule_list_memories | Enumera las memorias bajo una ruta con sus títulos y vistas previas breves. Es el índice virtual MainMemory. |
pathrule_read_memory | Devuelve el cuerpo completo de una memoria por id, incluido el token de versión para la concurrencia optimista. |
pathrule_write_memory | Crea una memoria en la ruta de un nodo. Los nodos que falten a lo largo de la ruta se crean automáticamente. Cuando se llama por MCP, el origen es claude de forma predeterminada. |
pathrule_update_memory | Edita una memoria existente: un reemplazo completo, o una edición pequeña y puntual con content_edit. move_to_path la reubica, y restore: true recupera una memoria eliminada. Pasa expected_version_id para que una edición simultánea genere un conflicto limpio. |
pathrule_delete_memory | Elimina una memoria de forma reversible. Se puede restaurar hasta que se elimine de forma permanente. hard: true la elimina de forma permanente y requiere un administrador del espacio de trabajo. |
El flujo predeterminado es usar get_context para encontrar el id de la memoria relevante, luego read_memory para obtener el cuerpo si el asistente necesita citarla, y write_memory cuando el usuario pide registrar algo.
Regla
| Herramienta | Propósito |
|---|---|
pathrule_read_rule | Devuelve el cuerpo completo de una regla por id. |
pathrule_write_rule | Crea una regla en la ruta de un nodo con un tipo de alcance (folder, file_type, project) y una prioridad (high, medium, low). También puede proponer un patrón de bloqueo o una comprobación obligatoria; la propuesta se guarda como propuesta, un agente no puede aprobarla y no se aplica nada hasta que una persona la apruebe. |
pathrule_update_rule | Edita una regla existente con concurrencia optimista. También la mueve a otra ruta o restaura una regla eliminada. |
pathrule_delete_rule | Elimina una regla de forma reversible. Se puede restaurar hasta que se elimine de forma permanente. |
Las reglas son de nivel de espacio de trabajo y pueden asociarse a más de un nodo. Si vas a escribir una regla dos veces en la misma ruta, usa la actualización y no la escritura, para evitar duplicados.
Skill
| Herramienta | Propósito |
|---|---|
pathrule_read_skill | Devuelve el cuerpo completo del SKILL.md de una skill por id. Para las skills github_ref, devuelve la instantánea en caché. |
pathrule_write_skill | Crea una skill en la ruta de un nodo. Acepta el SKILL.md completo, incluido el frontmatter. El origen puede ser manual, template o github_ref. |
pathrule_update_skill | Edita una skill existente con concurrencia optimista. También la mueve a otra ruta o restaura una skill eliminada. |
pathrule_delete_skill | Elimina una skill de forma reversible. Se puede restaurar hasta que se elimine de forma permanente. |
Para el flujo de creación, consulta Escribir skills. El asistente redacta primero un borrador y llama a pathrule_write_skill después de que el usuario aprueba el cuerpo.
Patrones
| Herramienta | Propósito |
|---|---|
pathrule_import_pattern | Previsualiza e importa un paquete publicado de memorias, reglas y skills en la ruta elegida del espacio de trabajo. |
pathrule_remove_pattern | Elimina las piezas que pertenecen a un paquete de patrones importado previamente. |
Actividad
| Herramienta | Propósito |
|---|---|
pathrule_log_activity | Registra de forma estructurada una respuesta que modifica archivos. Es obligatorio después de cada respuesta que crea, edita o elimina archivos. Campos: domain, action, scope, subjects, files_touched, task_summary. |
El registro de actividad alimenta la actividad reciente del espacio de trabajo, que la extensión de VS Code muestra en su vista Recent Activity, y las capas de aprendizaje derivadas. La granularidad correcta es un registro por respuesta (no por archivo).
Aprendizaje del proyecto
Lo que un agente deduce de tu código, guardado junto con los archivos que leyó y compartido con el espacio de trabajo. Consulta Aprendizaje del proyecto.
| Herramienta | Propósito |
|---|---|
pathrule_record_learning | Guarda un hallazgo al que llegó el agente leyendo el código, junto con los archivos que leyó y lo que contenían. Pathrule comprueba esos archivos en disco antes de aceptarlo. Un hallazgo no es una memoria, una regla ni una skill; llega al agente de cada miembro como un consejo que debe verificar, en el contexto que el agente solicita, mientras sus fuentes no cambien en esa copia de trabajo. Nunca se convierte en regla de forma automática. Pasa el id de un hallazgo anterior para reemplazarlo por uno corregido. |
pathrule_review_learning | Lista los hallazgos vigentes, obsoletos y en conflicto, incluidos los que se retienen fuera del contexto, y retira un hallazgo por id. Solo la persona cuyo agente registró un hallazgo puede retirarlo, y la retirada se aplica a todo el espacio de trabajo. |
pathrule_review_history | Lee discusiones de revisión anteriores en el origen de GitHub del repositorio usando tu sesión existente de gh, para que el agente pueda ver cómo resolvió el equipo una cuestión similar en el pasado. No almacena comentarios y omite las revisiones de bots, las externas y las descartadas; sin acceso a GitHub, todo lo demás sigue funcionando. |
Sugerencias y actualización
| Herramienta | Propósito |
|---|---|
pathrule_list_pending_refreshes | Lista las memorias y reglas obsoletas que la autoauditoría ha marcado. |
pathrule_get_refresh_brief | Reclama una tarea de actualización y devuelve el contexto completo para repararla, incluido el motivo de la auditoría y las instrucciones para el asistente. |
pathrule_resolve_refresh | Marca una tarea de actualización como aplicada o rechazada. Cierra el flujo de trabajo con intervención humana. |
pathrule_request_refresh | Marca una memoria o regla que el asistente encontró obsoleta, contradictoria, duplicada, demasiado específica o poco clara durante el trabajo normal. |
Las sugerencias son la forma en que Pathrule evita que el árbol de contenido se desvíe con el tiempo. El asistente puede señalar un problema concreto, reclamar un brief, proponer una corrección y resolverla, todo sin salir del editor.
Control local de escritura diferida
El servidor stdio local anuncia su conjunto completo de herramientas desde el primer tools/list: lecturas, escrituras, actualizaciones, eliminaciones, patrones, configuración inicial, actualización y actividad. No hay que desbloquear nada antes de la primera escritura, y la lista no cambia durante toda la sesión, así que una conversación larga nunca paga el costo de una lista de herramientas que cambia a mitad de camino.
Si prefieres empezar cada sesión con una lista más pequeña, el modo diferido está disponible de forma opcional. Define PATHRULE_MCP_TOOLS=lazy en el entorno de la entrada MCP de Pathrule. En el modo diferido, las herramientas de lectura y pathrule_log_activity son visibles al iniciar, y aparece una herramienta adicional:
| Herramienta | Propósito |
|---|---|
pathrule_enable_writes | Solo en modo diferido. Habilita las herramientas de escritura, actualización, eliminación, patrones, configuración inicial y modificación de actualizaciones durante el resto de la sesión MCP. Luego el servidor emite tools/list_changed una sola vez. |
El modo diferido no elimina nada; cambia el momento en que las herramientas de modificación se vuelven visibles. Sin la variable, o con cualquier otro valor, pathrule_enable_writes no existe porque no hay nada que habilitar.
Remote MCP alojado
Remote MCP tiene sus propios esquemas nativos de la nube. Un permiso de lectura expone siete herramientas: pathrule_get_context, además de herramientas de listado y lectura para memorias, reglas y skills. Un permiso de escritura añade escritura, actualización, eliminación e historial para cada tipo, con lo que el catálogo completo llega a diecinueve herramientas.
| Operación | Argumentos y comportamiento en remoto |
|---|---|
| Contexto, listados y lecturas | Limitados al espacio de trabajo aprobado en el permiso de OAuth |
| Escritura | path, title y body, con un id de operación estable |
| Actualización | id del elemento, expectedVersion numérico, title y body, con un id de operación estable |
| Eliminación | Eliminación reversible que conserva el historial, con el permiso de escritura |
| Historial | Historial por elemento, con el permiso de escritura |
El servidor de autorización reconoce pathrule:read, pathrule:write, pathrule:refresh y pathrule:activity. Los alcances reconocidos no añaden herramientas que no estén en el catálogo. Remote MCP no expone la administración de la organización, la configuración del espacio de trabajo, las instantáneas, la importación de patrones, el aprendizaje del proyecto, el registro de actividad ni los flujos de actualización. No instala hooks ni lee archivos locales.
Usa tools/list en el servidor conectado para ver sus esquemas exactos. Remote MCP explica la autorización y el límite de la entrega local.
Convenciones
Las convenciones siguientes se aplican a la superficie stdio local. Los esquemas remotos se describen más arriba.
- Escrituras basadas en la ruta. Las herramientas de escritura reciben un
node_pathrelativo al espacio de trabajo, como/apps/apio/. Si la ruta no existe, los nodos intermedios se crean automáticamente. - Concurrencia optimista. Las herramientas de actualización y eliminación aceptan un
expected_version_idobtenido en una lectura previa. Si no coincide, devuelven una respuesta de conflicto clara con la versión actual, para que el asistente pueda volver a leer y fusionar los cambios en lugar de sobrescribir. - Los duplicados se rechazan. Una memoria cuyo título ya existe en esa ruta, o una regla o skill cuyo nombre ya existe en el espacio de trabajo, se rechaza con un error de duplicado, para que el asistente actualice el registro existente. Una memoria o regla se puede forzar con
allow_duplicate: truedespués de que el asistente haya revisado la existente. - Compactas por defecto. Las respuestas son compactas para el caso habitual. En el servidor local, pasa
verbose: truecuando necesites recibir el registro completo. - Ids estables. Las respuestas de las herramientas incluyen valores estables de
idyversion_id. El asistente puede usarlos en llamadas posteriores sin volver a leer el elemento padre.
Qué leer a continuación
- Descripción general de MCP para conocer el modelo detrás de la superficie de herramientas.
- Cómo funcionan los hooks para conocer la capa de envío que complementa estas llamadas de consulta.
- Escribir memorias, Escribir reglas, Escribir skills para saber qué incluir en las escrituras.