Skip to main content
Glama
loctree-mcp

loctree-mcp

Official

Instalación

curl -fsSL https://loct.io/install.sh | sh   # One-liner (installs from crates.io)

O directamente a través de Cargo:

cargo install loctree        # CLI: loct, loctree
cargo install loctree-mcp    # MCP server for AI agents

Related MCP server: MCP Codebase Server

Inicio rápido

Los artefactos se almacenan en el directorio de caché de tu SO por defecto (se puede sobrescribir mediante LOCT_CACHE_DIR).

loct                              # Scan project, write cached artifacts
loct --for-ai                     # AI-optimized overview (health, hubs, quick wins)
loct slice src/App.tsx --consumers # Context: file + deps + consumers
loct find useAuth                  # Find symbol definitions
loct find 'Snapshot FileAnalysis'  # Cross-match: where terms meet
loct impact src/utils/api.ts       # What breaks if you change this?
loct health                        # Quick summary: cycles + dead + twins
loct dead --confidence high        # Unused exports
loct cycles                        # Circular imports
loct twins                         # Dead parrots + duplicates + barrel chaos
loct audit                         # Full codebase review

Qué hace

loctree captura el grafo de dependencias real de tu proyecto en un solo escaneo y luego responde preguntas estructurales al instante a partir de la instantánea. Diseñado para agentes de IA que necesitan contexto enfocado sin leer cada archivo.

Capacidades principales:

  • Fragmento holográfico - extrae archivo + dependencias + consumidores en una sola llamada

  • Búsqueda de coincidencia cruzada - encuentra dónde coexisten múltiples términos (no es un grep plano)

  • Detección de exportaciones muertas - encuentra exportaciones no utilizadas en JS/TS, Python, Rust, Go, Dart

  • Detección de importaciones circulares - el algoritmo SCC de Tarjan detecta bombas en tiempo de ejecución

  • Seguimiento de controladores - sigue los comandos de Tauri a través de toda la tubería FE/BE

  • Análisis de impacto - mira qué se rompe antes de eliminar o refactorizar

  • Consultas jq - consulta datos de instantáneas con sintaxis jq (loct '.files | length')

Servidor MCP

loctree se distribuye como un servidor MCP para una integración fluida con agentes de IA:

loctree-mcp    # Start via stdio (configure in your MCP client)

Herramientas: repo-view, slice, find, impact, focus, tree. Cada herramienta acepta un parámetro project: escanea automáticamente en el primer uso y almacena instantáneas en la RAM.

{
  "mcpServers": {
    "loctree": {
      "command": "loctree-mcp",
      "args": []
    }
  }
}

Soporte de idiomas

Idioma

Precisión de exportación muerta

Notas

Rust

~0% FP

Probado en rust-lang/rust (35K archivos)

Go

~0% FP

Probado en golang/go (17K archivos)

TypeScript/JavaScript

~10-20% FP

JSX/TSX, patrones de React, Flow, WeakMap

Python

~20% FP

Modo biblioteca, __all__, detección de stdlib

Svelte

<15% FP

Análisis de plantillas, re-exportaciones .d.ts

Vue

~15% FP

Soporte SFC, Composition & Options API

Dart/Flutter

Completo

Detección de pubspec.yaml

Detecta automáticamente la pila desde Cargo.toml, tsconfig.json, pyproject.toml, pubspec.yaml, src-tauri/.

Fragmento holográfico

Extrae contexto de 3 capas para cualquier archivo:

loct slice src/App.tsx --consumers
Slice for: src/App.tsx

Core (1 files, 150 LOC):
  src/App.tsx (150 LOC, ts)

Deps (3 files, 420 LOC):
  [d1] src/hooks/useAuth.ts (80 LOC)
    [d2] src/contexts/AuthContext.tsx (200 LOC)
    [d2] src/utils/api.ts (140 LOC)

Consumers (2 files, 180 LOC):
  src/main.tsx (30 LOC)
  src/routes/index.tsx (150 LOC)

Total: 6 files, 750 LOC

Búsqueda de coincidencia cruzada

Las consultas de múltiples términos muestran dónde se encuentran los términos, no un OR plano:

loct find 'Snapshot FileAnalysis'
=== Cross-Match Files (9) ===
  src/snapshot.rs: Snapshot(6), FileAnalysis(4)
  src/slicer.rs: Snapshot(2), FileAnalysis(3)
  ...

=== Symbol Matches (222 in cross-match files) ===
  src/snapshot.rs:20 - Snapshot [struct]
  src/types.rs:15 - FileAnalysis [struct]
  ...

=== Parameter Matches (4 cross-matched) ===
  src/slicer.rs:45 - snapshot: &Snapshot in build_slice(analyses: &[FileAnalysis])

Consultas jq

Consulta datos de instantáneas directamente:

loct '.dead_parrots'                           # Dead code findings
loct '.files | length'                         # Count files
loct '.edges[] | select(.from | contains("api"))' # Filter edges
loct '.summary.health_score'                   # Health score

Integración CI

loct lint --fail --sarif > results.sarif    # SARIF for GitHub/GitLab
loct --findings | jq '.dead_parrots | length'  # Check dead code count
loct doctor && echo 'Clean'                 # Health gate

Crates

Crate

Descripción

loctree

Analizador central + CLI (loct, loctree)

report-leptos

Renderizador de informes HTML (Leptos SSR)

loctree-mcp

Servidor MCP para agentes de IA

Desarrollo

make precheck        # fmt + clippy + check (run before push)
make install         # Install loct + loctree-mcp
make test            # Run all workspace tests
make publish         # Cascade publish to crates.io

Insignia

[![loctree](https://img.shields.io/badge/analyzed_with-loctree-a8a8a8?style=flat&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgdmlld0JveD0iMCAwIDE2IDE2Ij48cmVjdCB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIGZpbGw9IiMwMDAiLz48dGV4dCB4PSI4IiB5PSIxMiIgZm9udC1mYW1pbHk9Im1vbm9zcGFjZSIgZm9udC1zaXplPSIxMCIgZmlsbD0iI2E4YThhOCIgdGV4dC1hbmNob3I9Im1pZGRsZSI+TDwvdGV4dD48L3N2Zz4=)](https://crates.io/crates/loctree)

Licencia

MIT OR Apache-2.0. Consulta LICENSE-MIT y LICENSE-APACHE.


Creado con vibras de agentes de IA (c)2026 Equipo de Loctree

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that indexes your codebase using tree-sitter AST parsing and gives AI tools instant access to structural intelligence like dependency graphs, call trees, and dead code detection from a local SQLite database.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for semantic codebase navigation that builds an AST index of symbols, imports, and exports, providing AI agents with tools to search, explore, and understand code.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A local-first codebase intelligence layer for AI coding agents, providing a persistent, queryable model of a repository via an MCP server and CLI to enable structure queries instead of reading many files.
    Apache 2.0
  • A
    license
    B
    quality
    B
    maintenance
    Indexes a Python/JS/TS repository into a local SQLite knowledge graph so agents can trace callers, callees, imports, subclasses and covering tests, measure impact radius, rank diff risk, and summarize architecture without grepping files. Exposes these queries as MCP tools alongside an equivalent CLI, with no daemon, embeddings, or network access.
    10
    MIT