lore-mcp

LORE — это движок для археологии кода на основе плагинов для проектов на TypeScript. Он анализирует ваше AST, строит карту зависимостей, обнаруживает циклические зависимости, отслеживает цепочки асинхронных вызовов, оценивает безопасность типов и передает архитектурную информацию AI-помощникам через Model Context Protocol (MCP).

Создано EliotShift · Проверено в боевых условиях на 16 реальных проектах · 100% успешных проходов.

Почему LORE?

AI-помощники пишут код быстро, но им не хватает архитектурной памяти. Они не могут запомнить:

• Какие файлы сильно связаны

• Где находятся циклические зависимости

• Какие типы распространяются через границы модулей

• Какие файлы меняются слишком часто (горячие точки)

• Каковы архитектурные слои

LORE решает эту проблему, предоставляя вашему AI-помощнику глубокое понимание архитектуры вашей кодовой базы — через анализ CLI и интеграцию с MCP-сервером.

Related MCP server: Continuum

Возможности

13 анализаторов

Интеграция с MCP (8 инструментов + 3 ресурса)

Предоставьте LORE доступ к Claude Desktop, VS Code, Cursor или любому другому MCP-клиенту:

Команды 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

Документация

Веб-сайт: eliotshift.github.io/lore-mcp

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

Установка

npm install -g lore-mcp

Использование 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

Интеграция с MCP (Claude Desktop)

Добавьте это в конфигурацию 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"]
    }
  }
}

Или если установлено глобально:

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

Перезапустите Claude Desktop, затем спросите:

"Analyze my project architecture" → LORE запустит analyze_architecture "What are the circular dependencies?" → LORE запустит get-violations "Which files are hotspots?" → LORE запустит get-hotspots "What are the AI recommendations?" → LORE запустит get-recommendations

Архитектура

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

Система плагинов

LORE использует архитектуру на основе плагинов — каждый анализатор является плагином:

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

Встроенные плагины включают: circular-deps, coupling-matrix, dep-direction, entropy, gaps, hidden-coupling, hotspot, import-impact, middleware-chain, breaking-changes, type-safety, tooling-config, ai-recommendations.

Как это работает

1. Парсинг — LORE анализирует все файлы .ts/.tsx, используя гибридный парсер ts-morph + regex

2. Построение графа — Создает граф зависимостей с типизированными ребрами (import, type-ref, decorator, async-chain, implements, extends)

3. Запуск плагинов — 13 анализаторов запускаются параллельно через конвейер плагинов

4. Оценка — Вычисляет оценки состояния (безопасность типов, инструменты, архитектура, общая оценка 0–100)

5. Рекомендации — AI-движок генерирует приоритизированные предложения (от P0 критических до P3 желательных)

6. Обслуживание — Результаты доступны через вывод CLI, инструменты MCP или формат SARIF

Валидация

Все 16 тестовых проектов: 100% успешных проходов, ноль сбоев.

Требования

• Node.js >= 18.0.0

• TypeScript проект (анализирует файлы .ts и .tsx)

• Git (опционально, для анализа горячих точек)

• ripgrep (опционально, для более быстрого поиска файлов)

Технологический стек

Лицензия

MIT © 2025 EliotShift