Skip to main content
Glama
loctree-mcp

loctree-mcp

Official

Установка

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

Или напрямую через Cargo:

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

Related MCP server: MCP Codebase Server

Быстрый старт

Артефакты по умолчанию сохраняются в директории кэша вашей ОС (можно переопределить через 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

Что он делает

loctree фиксирует реальный граф зависимостей вашего проекта за одно сканирование, а затем мгновенно отвечает на структурные вопросы на основе этого снимка. Разработан для ИИ-агентов, которым нужен сфокусированный контекст без необходимости читать каждый файл.

Основные возможности:

  • Голографический срез — извлечение файла + зависимостей + потребителей за один вызов

  • Перекрестный поиск — поиск мест, где одновременно встречаются несколько терминов (не просто плоский grep)

  • Обнаружение неиспользуемых экспортов — поиск неиспользуемого кода в JS/TS, Python, Rust, Go, Dart

  • Обнаружение циклических импортов — алгоритм SCC Тарьяна для поиска критических ошибок во время выполнения

  • Трассировка обработчиков — отслеживание команд Tauri через весь конвейер FE/BE

  • Анализ влияния — узнайте, что сломается, прежде чем удалять или рефакторить

  • jq-запросы — запрос данных снимка с помощью синтаксиса jq (loct '.files | length')

MCP-сервер

loctree поставляется как MCP-сервер для бесшовной интеграции с ИИ-агентами:

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

Инструменты: repo-view, slice, find, impact, focus, tree. Каждый инструмент принимает параметр project — автоматическое сканирование при первом использовании, кэширование снимков в оперативной памяти.

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

Поддержка языков

Язык

Точность неиспользуемых экспортов

Примечания

Rust

~0% FP

Протестировано на rust-lang/rust (35 тыс. файлов)

Go

~0% FP

Протестировано на golang/go (17 тыс. файлов)

TypeScript/JavaScript

~10-20% FP

JSX/TSX, паттерны React, Flow, WeakMap

Python

~20% FP

Режим библиотеки, __all__, обнаружение stdlib

Svelte

<15% FP

Анализ шаблонов, .d.ts ре-экспорты

Vue

~15% FP

Поддержка SFC, Composition & Options API

Dart/Flutter

Полная

Обнаружение pubspec.yaml

Автоматическое определение стека из Cargo.toml, tsconfig.json, pyproject.toml, pubspec.yaml, src-tauri/.

Голографический срез

Извлечение 3-уровневого контекста для любого файла:

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

Перекрестный поиск

Запросы по нескольким терминам показывают, где они пересекаются, а не просто плоское ИЛИ:

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])

jq-запросы

Запрос данных снимка напрямую:

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

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

Crate-пакеты

Crate

Описание

loctree

Основной анализатор + CLI (loct, loctree)

report-leptos

Рендерер HTML-отчетов (Leptos SSR)

loctree-mcp

MCP-сервер для ИИ-агентов

Разработка

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

Бейдж

[![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)

Лицензия

MIT ИЛИ Apache-2.0. См. LICENSE-MIT и LICENSE-APACHE.


VibeCrafted с помощью ИИ-агентов (c)2026 Команда 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