rei-memory-mcp

Schreibgeschützter MCP-Server, der es Rei / Claude ermöglicht, das Rei-AIOS SEED_KERNEL (1.677+ Theorien, Stand 2026-08-19) per Volltextsuche, ID oder STEP abzufragen.

Phase 1 — nur lesen. Es wird kein Schreibpfad als MCP-Tool bereitgestellt. Die Aufnahme erfolgt über ein Einmalskript; Theorie-Ergänzungen und -Beförderungen gehören zu Phase 2 (seed_propose-Staging-Tabelle).

Designprinzip

Die dreistufige Taxonomie (proven / hypothesis / speculative) ist ein Pflichtfeld des Schemas. Eine Theorie ohne Stufe kann nicht aufgenommen werden. Die Disziplin der Epidemie-Hygiene wird durch das Schema durchgesetzt, nicht durch menschliche Aufmerksamkeit.

Related MCP server: Ek-Chuah MCP

Tools

Einrichtung

Python 3.11+ und SQLite 3.34+ (für den FTS5-Trigramm-Tokenizer — in Python 3.11+ enthalten).

# from repo root
python -m venv .venv
.venv/Scripts/activate            # Windows
source .venv/bin/activate         # Unix
pip install -e '.[dev]'

Erstellen der Datenbank

Das SEED_KERNEL liegt als TypeScript-Quellcode in rei-aios/src/axiom-os/seed-kernel*.ts vor. Als JSONL exportieren und dann aufnehmen:

# 1. dump (run inside the rei-aios repo; script is bundled there)
cd path/to/rei-aios
npx tsx scripts/dump-seed-kernel-json.ts > /path/to/rei-memory-mcp/data/seed-kernel-dump.jsonl

# 2. ingest into SQLite
cd path/to/rei-memory-mcp
python scripts/ingest.py \
    --input data/seed-kernel-dump.jsonl \
    --db    data/seed_kernel.db

Sowohl data/*.jsonl als auch data/*.db sind gitignored — bei Bedarf neu generieren.

Ausführen des MCP-Servers

# stdio transport (default)
python -m rei_memory_mcp.server
# or via console script:
rei-memory-mcp

Der DB-Pfad wird aus REI_MEMORY_DB gelesen (Standard: ./data/seed_kernel.db).

Claude-Desktop-Konfiguration

Zu den MCP-Einstellungen von Claude Desktop hinzufügen (Pfade anpassen):

{
  "mcpServers": {
    "rei-memory": {
      "command": "python",
      "args": ["-m", "rei_memory_mcp.server"],
      "cwd": "C:/Users/user/rei-memory-mcp",
      "env": {
        "REI_MEMORY_DB": "C:/Users/user/rei-memory-mcp/data/seed_kernel.db"
      }
    }
  }
}

Tests

pytest

Der Test für japanische Abfragen (test_search.py::test_japanese_query_hits) ist das tragende Signal — schlägt er fehl, ist der Trigramm-Tokenizer defekt und die Suche ist stillschweigend nutzlos.

Ehrlicher Umfang

• Nur lesen. Es existiert bewusst kein Schreib-MCP-Tool. Falsche Erinnerungen sollen keinen schnellen Weg in die Form haben.

• Trigramm-Japanisch. Abfragen mit 2 Zeichen oder weniger finden keine japanischen Texte (so funktioniert der Trigramm-Tokenizer). Verwenden Sie Abfragen mit 3+ Zeichen.

• STEP-Abdeckung. Nur ~3 % der aktuellen SEED_KERNEL-Einträge enthalten eine STEP N-Markierung im Text. seed_list_steps berichtet dies getreu.

• ID-Form. Das aktuelle SEED_KERNEL mischt drei ID-Muster (T-\d+, invented-*, Kebab-Case-Slug). Alle drei werden akzeptiert; keine Umformung.

• Keine Vektorsuche. FTS5-Trigramm ist die gesamte Retrieval-Geschichte in Phase 1. Sollte es sich als unzureichend erweisen, kann Phase 2 Embeddings ergänzend hinzufügen — nicht ersetzend.

Roadmap (nicht implementiert)

• Phase 2 — seed_propose-Staging-Tabelle + menschliche Freigabe → Beförderung in theories. Direkte Schreibzugriffe auf theories werden nicht als Tool bereitgestellt.

• Phase 3 — Tabelle der Beförderungshistorie, damit der Werdegang einer Theorie (hypothesis → proven) selbst ein Artefakt ist.

• Phase 4 — Zugriffszahl-Dämpfung für das Ranking. Zeilen mit immutable: true sind ausgenommen; es wird nie etwas gelöscht.

Lizenz

AGPL-3.0 (mit kommerziellen Dual-Lizenz-Bedingungen — siehe LICENSE). Entspricht dem Haupt-Repository rei-aios.

急がず、ゆっくりと。種は育ちます。