Lore Context

---

Lore Context とは

Lore Context は、AI エージェントのメモリーを管理するオープンコアのコントロールプレーンです。メモリー、検索、リポジトリーグラフ、ツールのトレースにまたがってコンテキストを構成し、独自のデータセットで検索品質を評価し、機密コンテンツのガバナンスレビューを振り分けます。また、バックエンド間で移行できるポータブルな交換形式でメモリーをエクスポートします。

別のメモリーデータベースを目指しているわけではありません。独自の価値は、メモリーの上位にある機能です。

• Context Query — メモリー＋ウェブ＋リポジトリー＋ツールのトレースを単一のエンドポイントで構成し、出典情報付きの段階評価されたコンテキストブロックを返します。
• Memory Eval — 独自のデータセットで Recall@K、Precision@K、MRR、stale-hit-rate、p95 latency を測定し、実行結果を保存して差分を比較し、リグレッションを検出します。
• Governance Review — 6 状態のライフサイクル（candidate / active / flagged / redacted / superseded / deleted）、リスクタグのスキャン、ポイズニングのヒューリスティック、変更不可の監査ログを備えています。
• MIF のようなポータビリティ — provenance / validity / confidence / source_refs / supersedes / contradicts を保持した JSON＋Markdown のエクスポート／インポート機能です。メモリーバックエンド間の移行形式として使用できます。
• Repo Graph — ファイル、シンボル、インポート、呼び出し、ルート、テストを決定論的にインデックス化し、API ルートと読み取り専用の MCP ツールとして公開します。エージェントは安定したプロジェクトコンテキストの契約に基づいて、リポジトリーに即した回答を作成できます。
• Multi-Agent Adapter — バージョンプローブと縮退モードへのフォールバックを備えた agentmemory のファーストクラス統合を提供し、追加ランタイム向けの明確なアダプター契約を用意しています。

使用する場面

次のような場合は Lore Context を使用してください	次のような場合はメモリデータベース（agentmemory、Mem0、Supermemory）を使用してください
エージェントが何を記憶し、なぜ記憶し、それが使われたかどうかを証明する必要がある	生のメモリを保存できればよい
複数のエージェント（Claude Code、Cursor、Qwen、Hermes、Dify）を実行しており、信頼できるコンテキストを共有したい	単一のエージェントを構築しており、ベンダーにロックインされるメモリ階層でも問題ない
コンプライアンス上、ローカルまたはプライベートなデプロイが必要	ホスト型 SaaS を利用したい
ベンダーのベンチマークではなく、独自のデータセットで評価したい	ベンダーのベンチマークで十分な判断材料になる
システム間でメモリを移行したい	バックエンドを切り替える予定がない

クイックスタート

# 1. Clone + install
git clone https://github.com/Lore-Context/lore-context.git
cd lore-context && pnpm install

# 2. Run the quickstart helper and inspect the activation report
pnpm quickstart -- --dry-run --activation-report

# 3. Generate a real API key (do not use placeholders in any environment beyond local-only dev)
export LORE_API_KEY=$(openssl rand -hex 32)

# 4. Start the API (file-backed, no Postgres required)
pnpm build && PORT=3000 LORE_STORE_PATH=./data/lore-store.json pnpm start:api

# 5. Write a memory
curl -H "Authorization: Bearer $LORE_API_KEY" -H "Content-Type: application/json" \
  -X POST http://127.0.0.1:3000/v1/memory/write \
  -d '{"content":"Use RDS as truth store and Qdrant as the derived recall index for Lore Context production.","memory_type":"project_rule","project_id":"demo"}'

# 6. Query context, then inspect the returned traceId in the Evidence Ledger
curl -H "Authorization: Bearer $LORE_API_KEY" -H "Content-Type: application/json" \
  -X POST http://127.0.0.1:3000/v1/context/query \
  -d '{"query":"production storage","project_id":"demo","token_budget":1200}'

公開ウェブサイトのクイックスタートについては、 lorecontext.com/quickstart をご覧ください。完全な セットアップ（Postgres、Docker Compose、ダッシュボード、MCP 統合）については、 docs/getting-started.md をご覧ください。

正式なアルファ版クイックスタートは git clone + pnpm quickstart です。Lore は現在、 公開の @lore-context/quickstart npm パッケージを公開しておらず、その存在も主張していません。 MCP stdio サーバーは、レジストリおよびクライアント向けに別途 @lore-context/server として公開されています。また、SDK ミドルウェアは @lore-context/sdk-middleware （npm）および lore-context-middleware（PyPI）として提供されています。

AI による読み取り可能な情報の検索向けに、ウェブサイトでは公開ドキュメントのみを対象として /llms.txt および /llms-full.txt を公開しています。公式 MCP Registry のエントリーは公開済みで、 追加の配布用ドラフトは docs/distribution にあります。 ローンチ用ドラフトは docs/launch に、デザインパートナーの受付情報は docs/design-partners にあります。公開ベンチマークページは、 再現可能な手法と小規模な動作確認レポートであり、競合に対するベンチマーク勝利を主張するものではありません。

アーキテクチャ

以下の図は、オープンコアとホスト型本番環境を合わせた全体構成を示しています。公開 OSS リポジトリでは、 ローカルファイル／Postgres へのデプロイを直接サポートしています。一方、ホスト型の Google サインイン、 AWS SQS ワーカー、プライベート埋め込み、課金、マルチテナント運用は、商用のホスト型クラウド機能です。

                       ┌───────────────────────────────────────────────┐
  MCP/REST clients ─► │ apps/api  (auth + rate limit + evidence)       │
  (Claude Code,       │   ├── Memory Inbox / lifecycle / audit         │
   Codex, Cursor,     │   ├── capture ingestion + recall hydration     │
   OpenCode...)       │   ├── context query (memory/web/repo/traces)   │
                       │   ├── repo graph query / symbol / impact       │
                       │   ├── Google sign-in + hosted MCP metadata     │
                       │   └── OpenAPI + usage + operator surfaces      │
                       └───────────────┬───────────────────────────────┘
                                       │
                         capture / embedding / graph jobs
                                       ▼
                       ┌───────────────────────────────────────────────┐
                       │ memory-worker  (AWS SQS + DLQ fan-out)        │
                       │   ├── auto redaction / curation / save        │
                       │   ├── dreaming butler (prune/merge/resolve)    │
                       │   ├── private Qwen3 embedding service         │
                       │   └── Qdrant dense+sparse indexing            │
                       └───────────────┬───────────────────────────────┘
                                       │
                  ┌────────────────────┼────────────────────┐
                  ▼                    ▼                    ▼
          RDS PostgreSQL 16      Qdrant derived index   apps/dashboard
          truth store + audit    lore_memories_v12      user-facing SaaS

詳しくは、docs/architecture.md をご覧ください。

v2.1.0 の内容

v2.1.0 は、Repo Graph API と MCP ツールのリリースです。Lore 自身のリポジトリグラフを、 エージェントメモリの主要な機能として提供します。ファイル、シンボル、インポート、呼び出し、ルート、 テスト、プロセスのヒントを対象に、決定論的な TypeScript／JavaScript リポジトリインデックスを作成します。 さらに、API ルートと読み取り専用の MCP ツールを通じて公開することで、場当たり的なテキスト検索ではなく、 安定したプロジェクトコンテキストの契約に基づいて、エージェントがリポジトリに関する回答を作成できるようにします。

v2.1.0 は現在のオープンコアのソースラインです。ホスト型の Lore Cloud 本番環境も、商用の AWS／Qdrant／プライベート埋め込み基盤上で v2.1.0 を実行しています。ただし、ホスト型の運用、課金、 本番リリースの自動化、Secret Vault のランタイムは Lore-Context/lore-cloud にあります。

機能	ステータス	場所
リポジトリーグラフ API ＋ MCP ツール（repo.graph_query / symbol_context / impact / detect_changes）	✅ OSS ＋ ホステッド環境で本番稼働	packages/repo-graph、apps/api、apps/mcp-server
コードナレッジグラフのインデクサー	✅ OSS ＋ ホステッド環境で本番稼働	packages/code-indexer、packages/code-indexer-python
メモリ、Web、リポジトリー、ツールのトレースを組み合わせるコンテキストクエリー	✅ OSS ＋ ホステッド環境で本番稼働	apps/api、docs/api-reference.md
7 ストリームの HybridSearchOrchestrator（FTS / pgvector / Qdrant の高密度＋疎検索 / グラフ / 時系列 / Wiki）	✅ OSS ＋ ホステッド環境で本番稼働	packages/search
クロスエンコーダーリランカー（フュージョン後、オプトイン）	✅ OSS、プロバイダーキーが必要	apps/api/src/rerankers/
夢見る執事によるメモリ統合（プルーニング / マージ / 解決 / 表示）	✅ OSS、フラグで有効化	apps/api/src/workers/butler-v18.ts
エージェントメモリの自己改善ループ ＋ コンテキストレシピ	✅ OSS、人間による承認後に昇格	packages/eval、packages/search
SDK ミドルウェア（OpenAI / Anthropic クライアント向けの自動注入 ＋ 自動保持）	✅ 公開済み	packages/sdk-middleware-typescript、packages/sdk-middleware-python
生成 SDK のソースプレビュー	✅ OSS ソースプレビュー	packages/sdk-python、packages/sdk-go、packages/sdk-java、packages/sdk-dotnet
ブラウザー拡張機能のキャプチャ用スキャフォールド	✅ OSS スキャフォールド	apps/browser-extension
AI エージェント向けシークレット保管庫（MCP ネイティブ、3 ボタン認証）	ホステッドベータ版、暗号監査待ち	Lore-Context/lore-cloud の商用ランタイム
クラウドメモリエンジン：RDS の真実ストア ＋ SQS ワーカーのファンアウト ＋ Qdrant インデックス	ホステッド環境で本番稼働	商用ホステッドクラウド
プライベートな Qwen3-Embedding-0.6B 1024 次元ベクトルサービス	ホステッド環境で本番稼働	商用ホステッドクラウド
自動キャプチャ取り込みと Memory Inbox の例外処理	✅ OSS ＋ ホステッド環境で本番稼働	apps/api、packages/capture、apps/dashboard
Google サインイン ＋ 個人用保管庫の初期設定	ホステッド環境で本番稼働	商用ホステッドクラウド
商用 SaaS：個人向けサブスクリプション、請求、クォータ制御	ホステッド環境で本番稼働	Lore-Context/lore-cloud
API キー認証（リーダー / ライター / 管理者）付き REST API	✅ OSS ＋ ホステッド環境で本番稼働	apps/api
/openapi.json の OpenAPI 3.1 コントラクト（2.1.0 を報告）	✅ OSS ＋ ホステッド環境で本番稼働	apps/api/src/openapi.ts
MCP stdio サーバー（レガシー ＋ 公式 SDK トランスポート）	✅ OSS ＋ ホステッド環境で本番稼働	apps/mcp-server
Next.js ダッシュボードの顧客ワークフロースキャフォールド	✅ OSS スキャフォールド ＋ ホステッド環境で本番稼働	apps/dashboard
Evidence Ledger API ＋ ダッシュボードの概要	✅ OSS ＋ ホステッド環境で本番稼働	apps/api、apps/dashboard
ガバナンス状態マシン ＋ 監査ログ	✅ OSS ＋ ホステッド環境で本番稼働	packages/governance
評価ランナー（Recall@K / Precision@K / MRR / staleHit / p95）	✅ OSS ＋ ホステッド環境で本番稼働	packages/eval
supersedes ＋ contradicts を含む MIF v0.2 のインポート / エクスポート	✅ OSS	packages/mif
モデルゲートウェイ（複数プロバイダーのタスク→モデルルーティング）	✅ OSS	packages/model-gateway
バージョンプローブ ＋ 縮退モードを備えた agentmemory アダプター	✅ OSS	packages/agentmemory-adapter
レート制限、フィールドの秘匿化に対応した構造化 JSON ロギング	✅ OSS ＋ ホステッド環境で本番稼働	apps/api
Docker Compose によるプライベートデプロイ	✅ OSS、セルフホスト可能	docker-compose.yml、docs/deployment/
ローカル導入ヘルパー pnpm quickstart ＋ アクティベーションレポート	✅ OSS	scripts/lore-quickstart.mjs
公式 MCP Registry ＋ 配布 / ローンチ / デザインパートナー向けドキュメント	✅ OSS ドキュメント	server.json、docs/distribution/、docs/launch/

すべてのリリース履歴については、CHANGELOG.md をご覧ください。

現在のリリース状況

v2.1.0 は、現在のソース、ホスト型本番環境、およびリリース系列です。最適化されたリリースフローを通じて AWS 本番環境と公開ウェブサイトにデプロイされました。このフローでは、変更不可の arm64 優先アーティファクト、ステージング API のスモークテスト、本番 API のデプロイ、独立したウェブサイトのデプロイ、リリース後の監査、タグとリリースの完了処理を行います。外部チェックにより、https://api.lorecontext.com/health が status=ok を返し、/openapi.json が 2.1.0 を報告し、https://lorecontext.com/status.html に v2.1.0 が含まれていることが確認されています。

本番環境では v1.1 以降の RDS／SQS／メモリーワーカー／Qdrant のクラウド構成を維持し、Qdrant コレクションには lore_memories_v12 を使用し、Postgres パスでは 1024 次元の pgvector を維持します。また、追加のリポジトリグラフスキーマ（apps/api/src/db/schema-v21-repo-graph.sql）が加わります。

現在の公開可能な状況のスナップショットについては docs/release-status.md を、リリースノート全文については docs/release-notes/v2.1.0.md をご覧ください。

リリースの重点

v2.1 リリースでは、Lore のリポジトリグラフをエージェントメモリーの主要な機能として位置付けます。場当たり的なテキスト検索ではなく、決定論的で安定したプロジェクトコンテキストの契約に基づいて、エージェントが「X はどこで定義されているか」「これは何を呼び出しているか」「これを変更したら何が壊れるか」に回答できるようにすることが目標です。

• @lore/repo-graph — ファイル、シンボル、インポート、呼び出し、ルート、テスト、プロセスのヒントを対象とする、決定論的な TypeScript／JavaScript リポジトリのインデックス作成。
• API ルート：POST /v1/repo/graph/query、POST /v1/repo/symbol/context、POST /v1/repo/impact、POST /v1/repo/detect-changes。
• MCP ツール：repo.graph_query、repo.symbol_context、repo.impact、repo.detect_changes（読み取り専用）。
• context_query(repo) は、利用可能な場合にプロバイダーを介して取得したリポジトリグラフのエビデンスを使用します。リポジトリグラフのストレージが設定されていない場合は、利用できないことを正直に示すフォールバックを使用します。
• リポジトリグラフの Postgres スキーマは追加型で、既存の本番スキーマに重ねて適用されます。本番環境およびステージング環境のスキーマ設定時に適用されます。

ルートおよび API パッケージのバージョンは 2.1.0 を報告するため、/openapi.json がリリースタグと一致します。リリース工程では、v2.0.9 以降に導入された、API とウェブサイトを分割してデプロイする最適化済みのガードレールを使用します。

docs/project-plan.md、docs/roadmap.md、および docs/release-governance.md をご覧ください。

インテグレーション

Lore Context は MCP と REST に対応しており、ほとんどのエージェント IDE やチャットフロントエンドと連携します。

ツール	セットアップガイド
Claude Code	docs/integrations/claude-code.md
Cursor	docs/integrations/cursor.md
Qwen Code	docs/integrations/qwen-code.md
OpenClaw	docs/integrations/openclaw.md
Hermes	docs/integrations/hermes.md
Dify	docs/integrations/dify.md
FastGPT	docs/integrations/fastgpt.md
Cherry Studio	docs/integrations/cherry-studio.md
Roo Code	docs/integrations/roo-code.md
OpenWebUI	docs/integrations/openwebui.md
その他／汎用 MCP	docs/integrations/README.md

デプロイ

モード	用途	ドキュメント
ローカルファイルベース	個人開発、プロトタイプ、スモークテスト	この README、上記のクイックスタート
ローカル Postgres+pgvector	単一ノードのローカルフォールバックと移行テスト	docs/deployment/README.md
プライベート Docker Compose	セルフホスト可能なチーム向けデプロイ、分離ネットワーク	docs/deployment/compose.private-demo.yml
ホスト型クラウド	RDS / SQS / memory-worker / Qdrant / プライベート埋め込みに加え、グラフ拡張ハイブリッド想起スタックと商用 SaaS 基盤	docs/release-status.md

すべてのデプロイ方法で、シークレットを明示的に指定する必要があります。ローカル／プライベート環境では POSTGRES_PASSWORD、LORE_API_KEYS、ダッシュボード認証が必要です。ホスト型デプロイにはさらに RDS、SQS、Qdrant、埋め込みサービス、OAuth、トンネル設定、本番ランタイムの環境変数が必要です。 scripts/check-env.mjs スクリプトは、いずれかの値がプレースホルダーパターンに一致する場合、本番環境での 起動を拒否します。

セキュリティ

v2.1.0 では、一般ユーザーによるアクセスに対し、ローカル／プライベート環境のデプロイ方針とホスト型クラウドの セーフガードを維持しています。

• 認証：ロール分離（reader／writer／admin）とプロジェクトごとのスコープ設定に対応した API キーのベアラートークン。本番環境ではキーなしモードを許可しません。
• レート制限：IP ごととキーごとの二重バケットに、認証失敗時のバックオフを適用します（60 秒以内に 5 回失敗すると 429 を返し、30 秒間ロックアウトします）。
• ダッシュボード：ホスト型製品では Google セッションフローを使用します。ローカル／プライベートの運用者向けデプロイでは HTTP Basic Auth も引き続き利用できます。
• コンテナ：すべての Dockerfile は非 root の node ユーザーで実行されます。api と dashboard には HEALTHCHECK を設定しています。
• シークレット：ハードコードされた認証情報はありません。すべてのデフォルト値は必須で、未設定の場合はエラーになります。scripts/check-env.mjs は本番環境でプレースホルダー値を拒否します。
• ガバナンス：書き込み時に PII／API キー／JWT／秘密鍵を正規表現でスキャンします。リスクタグ付きコンテンツは自動的にレビューキューへ送られ、状態遷移ごとに不変の監査ログを記録します。
• メモリポイズニング：合意に関するパターンと命令形の動詞パターンを使ってヒューリスティックに検出します。
• MCP：すべてのツール入力を zod スキーマで検証します。変更を伴うツールには reason（8 文字以上）が必要で、destructiveHint: true を提示します。上流エラーはクライアントに返す前にサニタイズされます。
• ワーカーの分離：キャプチャ、埋め込み、グラフ、コネクター、バックフィルのジョブは、DLQ を備えた AWS SQS キューを通じて実行されます。Qdrant は派生インデックスであり、RDS が引き続き権威あるデータソースです。
• ロギング：content、query、memory、value、password、secret、token、key フィールドを自動的に秘匿する構造化 JSON ログです。

脆弱性の報告については、SECURITY.md をご覧ください。

プロジェクト構成

apps/
  api/                # REST control plane + Postgres + governance + eval + repo graph
  dashboard/          # Next.js dashboard scaffold; hosted Google session stays commercial
  mcp-server/         # MCP stdio server (legacy + official SDK transports)
  cli/                # lore CLI (doctor, wiki-recompile, dataset import/export)
  browser-extension/  # Capture surface scaffold
  web/                # Server-side HTML renderer (no-JS fallback UI)
  website/            # Marketing site (handled separately)
packages/
  shared/             # Shared types, errors, ID/token utilities
  agentmemory-adapter # Bridge to upstream agentmemory + version probe
  search/             # 7-stream HybridSearchOrchestrator + recipe adapter
  repo-graph/         # Deterministic repository indexing (v2.1)
  code-indexer/       # Code knowledge graph indexer (TypeScript/JavaScript)
  code-indexer-python # Code knowledge graph indexer (Python)
  capture/            # Capture ingestion primitives
  connectors/         # External source connectors
  model-gateway/      # Multi-provider task→model routing
  mif/                # Memory Interchange Format (v0.2)
  eval/               # EvalRunner + metric primitives + context recipes
  governance/         # State machine + risk scan + poisoning + audit
  profile/            # Vault / account profile types
  sdk-typescript/     # TypeScript client SDK
  sdk-python/         # Python client SDK
  sdk-go/ sdk-java/ sdk-dotnet/   # Additional language SDKs
  sdk-middleware-typescript/      # Auto-inject + auto-retain middleware (npm)
  sdk-middleware-python/          # Auto-inject + auto-retain middleware (PyPI)
docs/
  i18n/<lang>/        # Localized README in 17 languages
  integrations/       # Agent-IDE integration guides
  deployment/         # Local and Docker Compose private deployment docs
  legal/              # Privacy / Terms / Cookies (Singapore law)
scripts/
  check-env.mjs       # Production-mode env validation
  smoke-*.mjs         # End-to-end smoke tests
  apply-postgres-schema.mjs

要件

• Node.js >=22
• pnpm 10.30.1
• （ローカルフォールバック用、任意）pgvector を備えた Postgres 16
• （ホスト型／高度な用途）RDS PostgreSQL 16、AWS SQS、Qdrant、プライベート埋め込みサービス

コントリビューション

コントリビューションを歓迎します。開発ワークフロー、コミットメッセージの規約、レビューに関する方針については、CONTRIBUTING.md をお読みください。

ドキュメントの翻訳については、i18n コントリビューターガイドをご覧ください。

運営元

Lore Context は REDLAND PTE. LTD.（シンガポール、UEN 202304648K）によって運営されています。会社概要、法的条件、データの取り扱いについては、docs/legal/ に記載されています。

ライセンス

Lore Context リポジトリは Apache License 2.0 のライセンスで提供されています。下流での利用を可能にするため、packages/* 内の個々のパッケージは MIT を宣言しています。上流への帰属表示については NOTICE をご覧ください。

謝辞

Lore Context は、ローカルメモリランタイムとして agentmemory を基盤に構築されています。上流の契約詳細とバージョン互換性ポリシーについては、UPSTREAM.md に記載されています。