local-rag-wiki

Ein repo-lokales RAG-Wiki für KI-Agenten: ein MCP-Wissensdienst pro Repository (kontrollierte Suche / Lesen / Schreiben von Markdown-Wiki-Notizen) plus ein Installer, der ihn in deine Agent-Tooling einbindet. Zum Ausführen des Dienstes ist Docker erforderlich.

Schnellstart (empfohlen)

Hole das Dienst-Image vor deiner ersten Agent-Sitzung vorab, um Kaltstart-Verzögerungen zu vermeiden:

docker pull ihorleleka/project-rag-wiki:latest

Related MCP server: hw_rag_mcp

Installation

Führe im Stammverzeichnis deines Repositorys aus:

npx github:ihorleleka/Local-Rag-Wiki install .

Dies erzeugt den verwalteten .agents/-Runner, den AGENTS.md-Richtlinienabschnitt, die MCP-Konfiguration für DeepSeek Harness (.dsh/mcp.servers.yml), Claude Code, Codex, VS Code und OpenCode sowie einen wiki/-Ordner. Diese Integrationen sind additiv: Die Installation der DSH-Unterstützung entfernt oder ersetzt die anderen Harness-Konfigurationen nicht. Der MCP-Dienst startet dann automatisch pro Repository, wenn sich dein Agent-Client verbindet. Das Vorabziehen des Images (siehe oben) wird empfohlen, bevor du den Agenten in einer neuen Umgebung ausführst.

DeepSeek Harness

Installiere das native DSH-Bundle einmal in das Profil, das du verwendest (normalerweise web):

dsh plugin --profile web add github:ihorleleka/Local-Rag-Wiki

Starte dieses DSH-Profil neu, öffne ein installiertes Repository als Workspace und starte eine Sitzung. Bei agent/created verwendet das Bundle den tatsächlichen Workspace des Agenten (einschließlich eines benutzerdefinierten --agents-dir), um DSHs offiziellen @deepseek-ai/dsh-mcp-client zu mounten, den verwalteten MCP-Runner zu starten, ihn erneut zu verbinden, seine Tools zu erkennen und vorhersehbare mcp__wiki-manager__*-Tools zu registrieren. Der Client bleibt auf den Agenten beschränkt, auch wenn der Namespace stabil ist. Der Runner startet den Docker-Dienst dieses Repositorys oder verbindet sich mit ihm – genau wie bei den anderen Harnesses.

Er mountet außerdem einen marker-gesteuerten Cordis-Recall-Koordinator für diesen Workspace: agent/session-start legt Hinweise zu wiederkehrenden Themen an; agent/pre-step verwendet den lokalen Zustand und führt dann nur bei einem relevanten Prompt eine begrenzte Wiki-Abfrage durch – zuerst wiki_search depth="abstract" (L0), dann passenden depth="packet"-Kontext (L1). Es kennzeichnet die Belege und überlässt die vollständigen L2-wiki_read-Entscheidungen dem Modell. session/event zeichnet eine Assistenten-Zusammenfassung auf, während agent/turn-stopping und session/flush den Zustand kürzen und persistieren. Der Recall wird pro Workspace zwischengespeichert und bei laufenden Anfragen dedupliziert; L1-Pakete sind ratenbegrenzt, Kaltstarts haben ein begrenztes 90-Sekunden-Kontingent, und Zustandsaktualisierungen werden mit atomarem Ersatz in die Warteschlange gestellt. Außerhalb eines Repositorys mit einem wiki-kit-Installationsmarker wird weder ein Zustand noch ein Wiki-Prozess verwendet.

Die generierte .dsh/mcp.servers.yml bleibt eine Alternative zur Workspace-Konfiguration; bevorzuge das Profil-Bundle, anstatt beide Brücken auszuführen, da dies zwei MCP-Verbindungen zu demselben Repository-Dienst erzeugen würde. AGENTS.md bleibt die portable Richtlinienebene.

Die Hooks unter .agents/hooks/ und .claude/settings.local.json sind Claude-Code-spezifisch. Die DSH-Lebenszyklus-Interception gehört in vertrauenswürdige Host-/Profil-Cordis-Plugins, nicht in ein projektlokales Hook-Manifest. Siehe .dsh/README.md für die Abgrenzung der Workspace-Konfiguration.

Aktualisierung

Nach der Installation aktualisierst du die verwalteten Dateien direkt aus dem Repo – kein npx erforderlich:

.agents\update-wiki-kit.cmd --force

sh .agents/update-wiki-kit.sh --force

Lebenszyklus

npx github:ihorleleka/Local-Rag-Wiki status .
npx github:ihorleleka/Local-Rag-Wiki restart .
npx github:ihorleleka/Local-Rag-Wiki doctor . --live

start ., stop . und pull . sind auf dieselbe Weise verfügbar. Der Repository-Container bleibt unabhängig von einzelnen Agent-Clients bestehen.

So funktioniert es

• Dieses Paket ist der Installer: Es richtet den .agents/-Runner und die MCP-Konfiguration in einem konsumierenden Repository ein und pflegt sie.

• kb-service/ ist der dockerisierte MCP-Wissensdienst, den der Runner pro Repository startet. Er stellt wiki_search, wiki_read, wiki_list, wiki_tree, wiki_schema_report, wiki_write, wiki_capture, wiki_delete und wiki_rename über POST /mcp/ bereit (standardmäßig Loopback), mit hashgeschützten Schreibvorgängen. wiki_search unterstützt abgestuften Abruf (depth=abstract|packet) sowie path_prefix-Verzeichnis-Scoping.

Versionierung

Der Installer und kb-service verwenden denselben Git-Tag (X.Y.Z oder vX.Y.Z). Release-Automatisierung:

• tag-version-verify.yml

• docker-release.yml

Lizenz

MIT (siehe kb-service/LICENSE).