Skip to main content
Glama
rei-meta-mcp

rei-meta-mcp

by fc0web

rei-meta-mcp

Eine Meta-Ebene über der Gruppe von Konnektoren. Sie behandelt die einzelnen MCP-Konnektoren als Objekte und die Zugriffspfade zu den Objekten als Morphismen und verwaltet deren Struktur.

Der einzige praktische Zweck von Phase 1 ist die Kohärenzprüfung (coherence check) — das maschinelle Abgleichen, ob die Inhalte mehrerer Quellen, die auf dasselbe Objekt verweisen, übereinstimmen.

Warum ich es gebaut habe

Am 2026-08-19 wurde im Implementierungsprozess von rei-memory-mcp festgestellt, dass SEED_KERNEL um 1,677 vs 1,675 abwich und 11 Tage lang unbemerkt blieb. Es wurde nur bemerkt, weil ein Mensch zufällig beide Zahlen verglich; es gab kein maschinelles Erkennungsmittel.

Die erste Aufgabe dieses Konnektors ist es, dies maschinell zuerst zu erkennen. Details siehe docs/incident-2026-08-19.md.

Related MCP server: MCP Discovery Server

Bereitgestellte Tools (3)

meta_list_sources(object_name?: str)

Listet die registrierten Quellen auf und gibt für jede den Erreichbarkeitsstatus, die Anzahl und den git-HEAD-Hash (Hinweis auf die Aktualität) zurück.

meta_check_coherence(object_name: str, detail: bool = False)

Gleicht die Fingerabdrücke der Quellen ab, die auf dasselbe Objekt verweisen, und gibt eines der folgenden Urteile zurück:

verdict

Bedeutung

coherent

Fingerabdrücke aller erreichbaren Quellen stimmen überein

divergent

Uneinigkeit zwischen erreichbaren Quellen

unreachable

Keine erreichbare Quelle

single_source

Nur eine erreichbare Quelle (kein Vergleich möglich)

§4 Kernregel: „Nicht erreichbar“ ist nicht „übereinstimmend“. unreachable und single_source werden immer als Warnung angezeigt.

Mit detail=True wird die tatsächliche Liste der abweichenden IDs (maximal 100) zurückgegeben.

meta_compose(from_source: str, to_source: str)

Phase 1 führt nur den Abgleich der output_schema- / input_schema-Zeichenketten im Registry durch. Die eigentliche Schema-Inferenz erfolgt ab Phase 3.

Was Phase 1 nicht tut

  • Automatische Reparatur (bewusst ausgeschlossen. Die Entscheidung, welche Seite richtig ist, trifft der Mensch)

  • Persistenz des Prüfverlaufs (Phase 2)

  • Schema-Inferenz (Phase 3)

  • Kategorientheoretische Konstruktionen wie Funktoren, Adjungierte, Monaden (wenn sie nötig werden)

Derzeit registrierte Quellen

Siehe config/sources.example.yaml:

source

kind

Status

rei-memory-local

sqlite

vollständiger Fingerabdruck (~/rei-memory-mcp/data/seed_kernel.db)

rei-aios-local-mcp

mcp_stdio

partieller Fingerabdruck (node dist/mcp/start-mcp.js als Subprozess starten und get_kernel_status aufrufen)

rei-aios-remote

unreachable_placeholder

Deploy über claude.ai remote-devices kann von Python aus nicht direkt geprüft werden — immer explizit unreachable

Installation & Verwendung

uv pip install -e ".[dev]"
cp config/sources.example.yaml config/sources.yaml   # パスを埋める
uv run pytest                                        # 全 PASS を確認
uv run rei-meta-mcp                                  # stdio で MCP server 起動

Der Registry-Pfad kann über die Umgebungsvariable REI_META_MCP_REGISTRY überschrieben werden.

Ehrlicher Umfang

  1. Nur Erkennung, keine Reparatur — die Entscheidung bleibt beim Menschen

  2. Die Übereinstimmung zwischen Quellen mit partiellem Fingerabdruck (mcp_stdio) bestätigt nur, dass „keine Abweichung vorliegt“, ist aber kein Beweis für „vollständige Übereinstimmung“ (es gibt Teile, die auf content_hash-Ebene nicht sichtbar sind)

  3. Nur fünf kategorientheoretische Begriffe tragen die Last (Objekt, Morphismus, Equalizer, Komposition, Identitätsmorphismus). Andere werden vermieden

  4. Derzeit ein Phase-1-Spike mit 3 Quellen. Eine Struktur, deren Wert mit der Anzahl der Objekte wächst

  5. Phase 2 (Verlauf, regelmäßige Ausführung, Benachrichtigungen) und Phase 3 (Schema-Inferenz, Verallgemeinerung der Morphismen) werden erst entschieden, nachdem Phase 1 im praktischen Betrieb funktioniert hat

Lizenz

AGPL-3.0-or-later.

Verwandtes

  • docs/incident-2026-08-19.md — Aufzeichnung des Vorfalls

  • tests/test_incident_2026_08_19.py — Test, der den Vorfall reproduziert

Available Tools

3 tools
meta_check_coherenceB

Check whether all sources for object_name agree.

Verdicts: coherent | divergent | unreachable | single_source. §4: unreachable/single_source are warnings, not silent success.

Inputs: object_name (required), detail. Returns: object

meta_composeA

Check whether the output of from_source can feed to_source.

Phase 1: declarative schema string match only.

Inputs: to_source (required), from_source (required). Returns: object

meta_list_sourcesA

List registered sources with current reachability and freshness.

Inputs: object_name. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a distinct responsibility: listing registered sources, checking source agreement for an object, and validating source-to-source composability. There is minimal overlap, and the differing parameters make selection unambiguous.

    Naming Consistency5/5

    All tools use the `meta_` prefix with an imperative snake_case verb (`list`, `check`, `compose`), giving a predictable convention. The slight variation in whether an object follows the verb does not hurt recognizability.

    Tool Count5/5

    Three tools is a compact but appropriate scope for a focused metadata validation server. Each tool provides a distinct high-level capability with no redundancy.

    Completeness4/5

    The set covers the core discovery and validation workflows: enumerate sources, check coherence, and test composition. It is missing broader source/object management and only performs schema-string composition matching, so there are minor gaps but no dead ends for the main use case.

    Maintenance

    ActivityStale
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers