ML

manhhailua/lorekeep

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

20 stars 2 forks 品質 63 トレンド 18MIT

Lorekeep — MCP による AI エージェントの一時的な知識グラフ

概要

Lorekeepは、複数の名前空間からdeterministicfacts.jsonlグラフにMarkdownをコンパイルし、ヒトで読みやすいObsidian/Tolaria wikiにグラフ化し、コンパクトな名前空間スコープ付きMCP表面をコーディングエージェント(Claude Code, Cursor, Codex, opencode, Grok build, Qoder, GitHub Copilot, Command Code)に公開します。 エージェントは、セッション中に事実を提案したり、付属のジャーナルに土地を提案したり、自信のある解決後に見えるようになります。 コンパイル時や、明示的に要求された深いインポート時に LLM の作業が行われます。 通常のグラフのクエリ、ジャーナルの書き込み、解決、wiki生成、lint、ステータスチェックは別のLMを呼び出すことはありません。 Lorekeep は、複数のコーディングエージェントと複数のデバイスを使用して 1 人に適しています。重要な現在の制約: Git バックアップ/同期は必須です。 同じ生の文書やジャーナルへの同時編集は、手動の競合の解像度を要求することができます。 共有認証されたチームサーバは、ロードマップの作業ではなく、出荷機能です.

概要(AI 翻訳)

あなたとあなたのコーディングによって共有されるファイルソバリン、一時的な知識グラフ MCP上のエージェント

Lorekeep は複数の名前空間から決定的なものに Markdown をコンパイルします [facts.jsonl グラフ、ヒト読みやすいオブシディアン/Tolaria にグラフするプロジェクト wiki は、コンパクトな名前空間スコープ付き MCP 表面をコーディングエージェントに露出します。 (ロードコード、カーソル、コーデックス、オープンコード、グルクビルド、Qoder、GitHub Copilot、 コマンド コード)。 エージェントはセッション中に事実を提案することもできます。提案 唯一のジャーナルに土地を置き、自信に満ちた解決の後に見えるようになります。

コンパイル時や、明示的に要求された深いインポート時に LLM の作業が行われます。 通常のグラフのクエリ、ジャーナルの書き込み、解決、wiki生成、lint、および ステータスチェックは別のLMを呼び出しません。

今日利用可能なもの

| エリア | 現在の行動 | お問い合わせ | コンパイル | [raw/ /*.md → スキーマ禁忌抽出 → 解決 → ソート [[facts.jsonl]] + マニフェスト + wiki | | 問い合わせ | 八方MCPツールと受動スキーマ、名前空間、ステータスリソース | | パーミッション | デンビー既定のネームスペースを1つでフィルタリング [[ScopedGraph チョークポイント | | 時間 | ハーフオープンの妥当性窓とスナップショット、歴史、変化の質問 |

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Lorekeep

A file-sovereign, temporal knowledge graph shared by you and your coding agents over MCP.

Lorekeep compiles Markdown from multiple namespaces into a deterministic facts.jsonl graph, projects that graph into a human-readable Obsidian/Tolaria wiki, and exposes a compact namespace-scoped MCP surface to coding agents (Claude Code, Cursor, Codex, opencode, Grok Build, Qoder, GitHub Copilot, Command Code). Agents can also propose facts during a session; proposals land in append-only journals and become visible after a confidence-gated resolve.

The LLM work happens during compile or an explicitly requested deep import. Ordinary graph queries, journal writes, resolve, wiki generation, lint, and status checks do not call another LLM.

What is available today

Area Current behavior
Compile raw//*.md → schema-constrained extraction → resolve → sorted facts.jsonl + manifest + wiki
Query Eight MCP tools plus passive schema, namespace, and status resources
Permission Deny-by-default namespace filtering through one ScopedGraph chokepoint
Time Half-open validity windows plus snapshot, history, and change queries
Agent input Native session-end capture where available; debounced idle/turn fallback for opencode and Command Code
Agent writes Namespace-enforced, confidence-gated journals; no direct graph mutation
Automation Watch raw docs, journals, memories/transcripts, agent wiring, backup sync, and restart after an external package upgrade
Human view Deterministic, readable Markdown wiki for Obsidian and Tolaria
Operations Runtime logs, redacted support bundles, install diagnostics, and optional automatic GitHub issues

Lorekeep is suitable for one person using several coding agents and several devices, with an important current constraint: Git backup/sync is sequential. Simultaneous edits to the same raw document or journal can still require manual conflict resolution. A shared authenticated team server is roadmap work, not a shipped capability.

Get started

1. Install

macOS / Linux (one-liner — auto-detects uv, pipx, or pip):

curl -fsSL https://raw.githubusercontent.com/manhhailua/lorekeep/main/scripts/install.sh | bash

Windows (PowerShell):

pip install --user lorekeep

Or with uv (all platforms):

uv tool install lorekeep

Verify the installation succeeded before continuing:

lorekeep version    # should print a version number

If lorekeep is not found, open a new terminal (so PATH updates take effect) or add ~/.local/bin to your PATH manually.

2. Initialize

lorekeep init

init sets up config, schema, provider, agent wiring, compiles any existing

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者?mcpskill.org のガイドから始めましょう →