lore-mcp

LORE es un motor de arqueología de código basado en plugins para proyectos TypeScript. Analiza tu AST, mapea dependencias, detecta dependencias circulares, rastrea cadenas asíncronas, puntúa la seguridad de tipos y proporciona inteligencia arquitectónica a los asistentes de programación con IA a través del Protocolo de Contexto de Modelo (MCP).

Creado por EliotShift · Probado en batalla en 16 proyectos del mundo real · 100% de tasa de éxito.

¿Por qué LORE?

Los asistentes de programación con IA escriben rápido, pero carecen de memoria arquitectónica. No pueden recordar:

• Qué archivos están estrechamente acoplados

• Dónde residen las dependencias circulares

• Qué tipos se están propagando a través de los límites

• Qué archivos cambian con demasiada frecuencia (puntos críticos o hotspots)

• Cuáles son las capas arquitectónicas

LORE resuelve esto dándole a tu asistente de IA una comprensión profunda de la arquitectura de tu base de código, a través del análisis por CLI y la integración con el servidor MCP.

Related MCP server: Continuum

Características

13 Analizadores

Integración MCP (8 herramientas + 3 recursos)

Expón LORE a Claude Desktop, VS Code, Cursor o cualquier cliente MCP:

Comandos CLI

lore [path]                   Analyze project (default: cwd)
lore analyze [path]           Explicit analysis
lore init                     Extract architectural decisions
lore status                   View decisions by category
lore diff                     Diff against saved baseline
lore doctor                   Environment + tooling check
lore doctor --fix             Auto-fix project setup
lore ignore                   List/manage ignore patterns
lore watch                   Watch + re-analyze on change
lore mcp inspect             Inspect MCP server setup
lore mcp config              Claude Desktop config snippet
lore version                  Show version

Documentación

Sitio web: eliotshift.github.io/lore-mcp

Inicio rápido

Instalación

npm install -g lore-mcp

Uso de CLI

# Analyze current project
lore

# Analyze a specific project
lore ./my-typescript-project

# Check environment and auto-fix
lore doctor --fix

# Watch for changes
lore watch --filter src/

# Diff from last baseline
lore diff

Integración MCP (Claude Desktop)

Añade esto a tu configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "lore": {
      "command": "npx",
      "args": ["-y", "lore-mcp"]
    }
  }
}

O si se instaló globalmente:

{
  "mcpServers": {
    "lore": {
      "command": "lore",
      "args": ["mcp"]
    }
  }
}

Reinicia Claude Desktop y luego pregunta:

"Analyze my project architecture" → LORE ejecuta analyze_architecture "What are the circular dependencies?" → LORE ejecuta get-violations "Which files are hotspots?" → LORE ejecuta get-hotspots "What are the AI recommendations?" → LORE ejecuta get-recommendations

Arquitectura

lore-mcp/
├── src/
│   ├── algorithm/          # LoreGraph, AST parser, async chain builder, type tracker
│   ├── algorithms/         # AI recommendations, hotspot analysis, entropy, scoring
│   ├── analyzer/           # Dependency parsers, circular deps, direction, imports
│   ├── commands/           # CLI: doctor, diff, ignore, init, status, watch
│   ├── core/               # Plugin system, pipeline runner, graph engine
│   ├── lib/                # Hidden coupling, gaps, middleware chain, ontology
│   ├── mcp/                # MCP server + architecture bridge
│   ├── output/             # Formatter, markdown, SARIF, logger
│   ├── plugins/built-in/   # 13 built-in analysis plugins
│   ├── storage/            # Cache and decision store
│   ├── types/              # TypeScript type definitions
│   ├── cli.ts              # CLI entry point
│   └── index.ts            # MCP server entry point
├── package.json
└── tsconfig.json

Sistema de plugins

LORE utiliza una arquitectura basada en plugins: cada analizador es un plugin:

interface LorePlugin {
  name: string;
  version: string;
  analyze(context: AnalysisContext): Promise<PluginResult>;
}

Los plugins integrados incluyen: circular-deps, coupling-matrix, dep-direction, entropy, gaps, hidden-coupling, hotspot, import-impact, middleware-chain, breaking-changes, type-safety, tooling-config, ai-recommendations.

Cómo funciona

1. Analizar (Parse) — LORE analiza todos los archivos .ts/.tsx usando un analizador híbrido de ts-morph + regex

2. Construir grafo — Construye un grafo de dependencias con bordes tipados (importación, referencia de tipo, decorador, cadena asíncrona, implementa, extiende)

3. Ejecutar plugins — 13 analizadores se ejecutan en paralelo a través de la tubería de plugins

4. Puntuar — Calcula puntuaciones de salud (seguridad de tipos, herramientas, arquitectura, general 0–100)

5. Recomendar — El motor de IA genera sugerencias priorizadas (P0 crítico → P3 deseable)

6. Servir — Resultados disponibles a través de la salida CLI, herramientas MCP o formato SARIF

Validación

Los 16 proyectos de prueba: 100% tasa de éxito, cero fallos.

Requisitos

• Node.js >= 18.0.0

• Proyecto TypeScript (analiza archivos .ts y .tsx)

• Git (opcional, para análisis de puntos críticos)

• ripgrep (opcional, para un descubrimiento de archivos más rápido)

Stack tecnológico

Licencia

MIT © 2025 EliotShift