lore-mcp
LOREは、TypeScriptプロジェクト向けのプラグインベースのコード考古学エンジンです。ASTを解析し、依存関係をマッピングし、循環参照を検出し、非同期チェーンを追跡し、型の安全性をスコアリングします。そして、Model Context Protocol (MCP) を通じて、AIコーディングアシスタントにアーキテクチャの知見を提供します。
EliotShiftによって構築 · 16の実プロジェクトで実戦テスト済み · 合格率100%
なぜLOREなのか?
AIコーディングアシスタントは高速にコードを書きますが、アーキテクチャの記憶が欠けています。以下のようなことを記憶できません:
どのファイルが密結合しているか
循環依存がどこにあるか
どの型が境界を越えて広がっているか
どのファイルが頻繁に変更されているか(ホットスポット)
アーキテクチャのレイヤーがどうなっているか
LOREは、CLI分析とMCPサーバー統合を通じて、AIアシスタントにコードベースのアーキテクチャに対する深い理解を与えることで、この問題を解決します。
Related MCP server: Continuum
機能
13の分析機能
# | アナライザー | 機能 |
1 | ASTパーサー | ts-morphと正規表現を組み合わせた完全なTypeScript/TSX解析 |
2 | 依存関係グラフ | プロジェクト全体のすべてのインポート、エクスポート、再エクスポートをマッピング |
3 | 循環依存検出器 | 循環参照を見つけ、深刻度順にランク付け |
4 | 依存関係方向チェッカー | レイヤー規則の強制(例:コントローラーからDBへのインポート禁止) |
5 | シャノンエントロピー | ファイルごとの複雑性スコアリング(単純 → 非常に複雑) |
6 | ホットスポット分析 | Gitチャーン検出 — 変更頻度が高すぎるファイルを特定 |
7 | インポート影響分析 | すべてのインポートの爆発半径(影響範囲)を表示 |
8 | 型安全性スコアラー |
|
9 | 隠れた結合検出器 | 共有型を通じた暗黙的な依存関係を見つける |
10 | AI推奨事項 | 優先順位付けされた修正提案(P0–P3) |
11 | ツール設定チェッカー | ESLint、Prettier、tsconfigの設定を検証 |
12 | 破壊的変更検出器 | リスクの高い非推奨パターンにフラグを立てる |
13 | アーキテクチャギャップファインダー | 不足している抽象化やパターンを特定 |
MCP統合 (8つのツール + 3つのリソース)
LOREをClaude Desktop、VS Code、Cursor、または任意のMCPクライアントに公開します:
ツール | 説明 |
| プロジェクト全体の分析 — スコア、違反、複雑性、ホットスポット |
| ヘルススコア:全体、型安全性、ツール、アーキテクチャ |
| 循環参照、レイヤー違反、アーキテクチャのギャップ |
| AIによる改善提案(P0–P3) |
| Gitチャーンが高いファイル(赤/黄/緑) |
| シャノンエントロピー複雑性レポート |
| ファイルのインポート、エクスポート、コンシューマー、複雑性 |
| 詳細なTS分析:フレームワーク、レイヤー、非同期チェーン、型フロー |
リソース | 説明 |
| 最新の分析結果 (JSON) |
| 詳細なアーキテクチャグラフ (JSON) |
| 環境およびキャッシュの状態 (JSON) |
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、npx、Dockerでのインストール | |
すべてのCLIコマンド:init, status, doctor, watch, diffなど | |
Claude Desktop、Cursor、Windsurfの設定 | |
Express、NestJS、Next.jsなどの実プロジェクト分析例 | |
よくある質問 |
クイックスタート
インストール
npm install -g lore-mcpCLIの使用方法
# 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 diffMCP統合 (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を再起動し、以下のように尋ねてください:
"プロジェクトのアーキテクチャを分析して" → LOREが
analyze_architectureを実行 "循環依存関係はどこにある?" → LOREがget-violationsを実行 "ホットスポットになっているファイルはどれ?" → LOREがget-hotspotsを実行 "AIからの推奨事項は何?" → 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。
仕組み
解析 (Parse) — LOREは、ts-morphと正規表現を組み合わせたハイブリッドパーサーを使用して、すべての
.ts/.tsxファイルを解析しますグラフ構築 (Build Graph) — 型付きエッジ(import, type-ref, decorator, async-chain, implements, extends)を持つ依存関係グラフを構築します
プラグイン実行 (Run Plugins) — 13のアナライザーがプラグインパイプラインを通じて並列実行されます
スコアリング (Score) — ヘルススコア(型安全性、ツール、アーキテクチャ、総合0–100)を計算します
推奨 (Recommend) — AIエンジンが優先順位付けされた提案(P0 致命的 → P3 あれば望ましい)を生成します
提供 (Serve) — 結果はCLI出力、MCPツール、またはSARIF形式で利用可能です
検証
プロジェクト | ファイル数 | 結果 | |
Express | 42 | 100% 合格 | |
Next.js | 68 | 100% 合格 | |
Fastify | 55 | 100% 合格 | |
NestJS | 38 | 100% 合格 | |
Prisma | 45 | 100% 合格 | |
Zod | 35 | 100% 合格 | |
TypeORM | 60 | 100% 合格 | + 他9プロジェクト |
16のテストプロジェクトすべて:合格率100%、クラッシュゼロ。
要件
Node.js >= 18.0.0
TypeScript プロジェクト (
.tsおよび.tsxファイルを分析)Git (オプション、ホットスポット分析用)
ripgrep (オプション、より高速なファイル探索用)
技術スタック
コンポーネント | 技術 |
言語 | TypeScript 5.5+ |
AST解析 | ts-morph 21 |
プロトコル | Model Context Protocol (MCP) SDK 1.0 |
トランスポート | Stdio (Claude Desktop / IDE互換) |
検証 | Zod スキーマ |
出力 | ANSIターミナル, Markdown, SARIF |
ライセンス
MIT © 2025 EliotShift
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
AlicenseNot gradedqualityCmaintenanceProvides persistent memory for AI coding assistants, storing and retrieving architectural decisions, patterns, and solutions across sessions using semantic search, while also offering git integration for commit messages and code expertise mapping.MIT- AlicenseNot gradedqualityDmaintenanceAutomatically extracts architectural decisions, patterns, and insights from Git commits to build a local, structured project memory. It exposes this living context to AI tools via MCP, allowing them to understand the historical reasoning and evolution behind your codebase.417MIT
- AlicenseAqualityAmaintenanceLocal-first memory layer for AI coding agents — captures issues, attempts, fixes, and decisions, and warns at git commit before you repeat a mistake.15665MIT
- AlicenseNot gradedqualityDmaintenanceProvides AI coding assistants with persistent, context-rich memory of a codebase, including documentation and git history, enabling recall across sessions.105Apache 2.0
Related MCP Connectors
AI Agent with Architectural Memory. Impact analysis (free), tests and code from the graph (pro).
Deterministic context layer for your codebase: change impact, blast radius, answers with receipts.
Give your AI agent a persistent map of your project's structure, dependencies, and bugs.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/EliotShift/lore-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server