lore-mcp

LORE ist eine plugin-basierte Code-Archäologie-Engine für TypeScript-Projekte. Sie analysiert Ihren AST, bildet Abhängigkeiten ab, erkennt zirkuläre Abhängigkeiten, verfolgt Async-Ketten, bewertet die Typsicherheit und liefert architektonische Intelligenz an KI-Programmierassistenten über das Model Context Protocol (MCP).

Entwickelt von EliotShift · Praxiserprobt an 16 realen Projekten · 100% Erfolgsquote.

Warum LORE?

KI-Programmierassistenten schreiben schnell, aber ihnen fehlt das architektonische Gedächtnis. Sie können sich nicht merken:

• Welche Dateien eng gekoppelt sind

• Wo zirkuläre Abhängigkeiten existieren

• Welche Typen sich über Grenzen hinweg ausbreiten

• Welche Dateien zu oft geändert werden (Hotspots)

• Was die architektonischen Schichten sind

LORE löst dies, indem es Ihrem KI-Assistenten ein tiefes Verständnis Ihrer Codebasis-Architektur vermittelt – durch CLI-Analyse und MCP-Server-Integration.

Related MCP server: Continuum

Funktionen

13 Analysatoren

MCP-Integration (8 Tools + 3 Ressourcen)

Stellen Sie LORE für Claude Desktop, VS Code, Cursor oder jeden MCP-Client bereit:

CLI-Befehle

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

Dokumentation

Website: eliotshift.github.io/lore-mcp

Schnellstart

Installieren

npm install -g lore-mcp

CLI-Nutzung

# 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

MCP-Integration (Claude Desktop)

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu:

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"]
    }
  }
}

Oder bei globaler Installation:

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

Starten Sie Claude Desktop neu und fragen Sie dann:

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

Architektur

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

Plugin-System

LORE verwendet eine plugin-basierte Architektur — jeder Analysator ist ein Plugin:

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

Zu den integrierten Plugins gehören: circular-deps, coupling-matrix, dep-direction, entropy, gaps, hidden-coupling, hotspot, import-impact, middleware-chain, breaking-changes, type-safety, tooling-config, ai-recommendations.

Funktionsweise

1. Parsen — LORE parst alle .ts/.tsx-Dateien mit einem hybriden ts-morph + Regex-Parser

2. Graph erstellen — Konstruiert einen Abhängigkeitsgraphen mit typisierten Kanten (Import, Typ-Ref, Decorator, Async-Kette, Implements, Extends)

3. Plugins ausführen — 13 Analysatoren laufen parallel durch die Plugin-Pipeline

4. Bewerten — Berechnet Gesundheits-Scores (Typsicherheit, Tooling, Architektur, Gesamt 0–100)

5. Empfehlen — KI-Engine generiert priorisierte Vorschläge (P0 kritisch → P3 nice-to-have)

6. Bereitstellen — Ergebnisse verfügbar über CLI-Ausgabe, MCP-Tools oder SARIF-Format

Validierung

Alle 16 Testprojekte: 100% Erfolgsquote, null Abstürze.

Anforderungen

• Node.js >= 18.0.0

• TypeScript-Projekt (analysiert .ts und .tsx-Dateien)

• Git (optional, für Hotspot-Analyse)

• ripgrep (optional, für schnellere Dateisuche)

Tech-Stack

Lizenz

MIT © 2025 EliotShift