rei-meta-mcp

A meta-layer standing on top of the connector group. It treats individual MCP connectors as objects and access paths to those objects as morphisms, and handles their structure.

The only practical purpose of Phase 1 is coherence check — mechanically cross-checking whether the contents match across multiple sources pointing to the same object.

Why it was made

On 2026-08-19, during the implementation of rei-memory-mcp, it was discovered that SEED_KERNEL had drifted by 1,677 vs 1,675 for 11 days without being noticed. It was noticed only because a human happened to compare both numbers by chance; there was no mechanical means of detection.

The first job of this connector is to let the machine find this first. See docs/incident-2026-08-19.md for details.

Related MCP server: Code-Oracle

Provided tools (3)

meta_list_sources(object_name?: str)

Enumerates registered sources and returns each one's reachability status, count, and git HEAD hash (a clue to freshness).

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

Cross-checks the fingerprints of sources pointing to the same object and returns one of the following verdicts:

§4 Core rule: "unreachable" is not "matched". unreachable and single_source are always surfaced as warnings.

With detail=True, returns the actual list of mismatched IDs (up to 100 items).

meta_compose(from_source: str, to_source: str)

Phase 1 only does string matching of output_schema / input_schema in the registry. Actual schema inference is Phase 3 and later.

What Phase 1 does not do

• Automatic repair (intentionally excluded. Judgment of which is correct is left to humans)

• Persistence of inspection history (Phase 2)

• Schema inference (Phase 3)

• Categorical constructions such as functors, adjunctions, monads, etc. (when the need arises)

Currently registered sources

See config/sources.example.yaml:

Install & usage

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 起動

The registry path can be overridden with the environment variable REI_META_MCP_REGISTRY.

Honest scope

1. Detection only, no repair — does not take judgment outside of humans

2. Matching among partial fingerprint sources (mcp_stdio) is confirmation that "there is no mismatch", not proof of "exact match" (there are parts not visible at the content_hash level)

3. Only 5 category theory terms carry weight (object, morphism, equalizer, composition, identity morphism). Others are avoided

4. Currently a Phase 1 spike with 3 sources. A structure whose value increases as the number of objects grows

5. Phase 2 (history, scheduled execution, notifications) and Phase 3 (schema inference, generalization of morphisms) will be decided after Phase 1 works in real operation

License

AGPL-3.0-or-later.

Related

• docs/incident-2026-08-19.md — record of the incident

• tests/test_incident_2026_08_19.py — test that reproduces the incident