lore MCP

LORE

Type-Aware Architectural Memory for AI Coding

v0.1.6 ·

·

·

·

·

·

______________________________________________________________________

LORE是一个 基于插件的代码考古引擎 对于TypeScript项目。它解析您的AST，映射依赖关系，检测循环deps，跟踪异步链，对类型安全进行评分，并通过 模型上下文协议（MCP）.

建造于 EliotShift 的 ·在16个真实世界的项目中进行了战斗测试，通过率为100%。

______________________________________________________________________

为什么是LORE？

AI编码助手写得很快，但他们缺乏 建筑记忆。他们不记得了：

• 哪些文件是紧密耦合的
• 循环依赖存在的地方
• 哪些类型正在跨越边界传播
• 哪些文件更改太频繁（热点）
• 什么是建筑层

LORE通过为您的AI助手提供 深入了解您的代码库架构 --通过CLI分析和MCP服务器集成。

______________________________________________________________________

特性

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

______________________________________________________________________

文档

网站：

______________________________________________________________________

快速开始

安装

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配置中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Linux： ~/.config/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

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

或者，如果全局安装：

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

重新启动Claude Desktop，然后问：

“分析我的项目架构”→ LORE跑步 analyze_architecture “循环依赖是什么？”→ LORE跑步 get-violations “哪些文件是热点？”→ LORE跑步 get-hotspots “人工智能的建议是什么？”→ 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
;
}

内置插件包括： 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. 构建图 --构造一个具有类型化边（导入、类型引用、装饰器、异步链、实现、扩展）的依赖图
3. 运行插件 --13个分析器通过插件管道并行运行
4. 得分 --计算健康评分（类型安全、工具、架构，总体0-100）
5. 推荐 --AI引擎生成优先建议（P0关键→ P3很高兴有）
6. 服务 --结果可通过CLI输出、MCP工具或SARIF格式获得

______________________________________________________________________

验证

全部16个测试项目：100%通过率，零碰撞。

______________________________________________________________________

支持的平台

LORE是建立在 Node.js --没有本地依赖关系。如果Node.js在您的系统上运行，LORE也会运行。

按平台快速安装

# macOS (Homebrew)
brew install node
npm install -g lore-mcp

# Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash -
sudo apt install -y nodejs lore-mcp

# Kali Linux
sudo apt install nodejs npm
npm install -g lore-mcp

# Fedora
sudo dnf install nodejs npm
npm install -g lore-mcp

# Arch Linux
sudo pacman -S nodejs npm
npm install -g lore-mcp

# Windows (PowerShell)
npm install -g lore-mcp

# Or anywhere — no install needed
npx lore-mcp init

______________________________________________________________________

需求

• Node.js >= 18.0.0
• TypeScript 项目（分析 .ts 和 .tsx 文件）
• Git （可选，用于热点分析）
• ripgrep （可选，用于更快地发现文件）

______________________________________________________________________

技术栈

______________________________________________________________________

许可证

麻省理工学院©2025 EliotShift 的

______________________________________________________________________

LORE — Because your AI should understand your architecture, not just your code.