rei-meta-mcp

Мета-уровень, стоящий над группой коннекторов. Рассматривает отдельные MCP-коннекторы как объекты, пути доступа к объектам — как морфизмы, и работает с этой структурой.

Зачем это сделано

2026-08-19 в процессе реализации rei-memory-mcp выяснилось, что SEED_KERNEL расходился на 1,677 против 1,675 и оставался незамеченным в течение 11 дней. Заметить это смог только человек, случайно сравнив оба числа, — у машины не было средств обнаружения.

Первая задача этого коннектора — чтобы машина обнаруживала это первой. Подробности: docs/incident-2026-08-19.md.

Related MCP server: Code-Oracle

Предоставляемые инструменты (3 шт.)

meta_list_sources(object_name?: str)

Перечисляет зарегистрированные source и возвращает для каждого состояние достижимости, количество записей и хэш HEAD (как признак свежести).

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

Сверяет отпечатки source, указывающих на один и тот же объект, и возвращает один из следующих вердиктов:

Основное правило: «недостижимо» — это не «совпадает». unreachable и single_source всегда отображаются как предупреждение.

При detail=True возвращается фактический список идентификаторов с расхождениями (максимум 100 записей).

meta_compose(from_source: str, to_source: str)

На этапе 1 — только сопоставление строк output_schema / input_schema в реестре. Вывод фактической схемы — начиная с этапа 3.

Что не делается на этапе 1

• Автоматическое исправление (намеренно исключено; решение о том, что верно, принимает человек)

• Сохранение истории проверок (этап 2)

• Вывод схемы (этап 3)

• Конструкции теории категорий — функторы, сопряжения, монады и т.п. (если возникнет необходимость)

Текущие зарегистрированные source

См. config/sources.example.yaml:

Установка и использование

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

Путь к реестру можно переопределить переменной окружения REI_META_MCP_REGISTRY.

Честная область применения

1. Только обнаружение, без исправления — решение остаётся за человеком.

2. Частичный отпечаток для source типа mcp_stdio — это подтверждение отсутствия расхождений, а не доказательство полного совпадения (не проверяются части, не покрытые content_hash).

3. Терминология теории категорий — только пять терминов (объект, морфизм, уравнитель, композиция, тождественный морфизм); никакой дополнительной нагрузки.

4. Сейчас — 3 source, этап 1 — ценность растёт по мере увеличения числа объектов.

5. Этап 2 (история, регулярные проверки) и этап 3 (вывод схемы, морфизмы) — только после того, как этап 1 заработает в реальной эксплуатации.

Лицензия

AGPL-3.0-or-later.

Связанные материалы

• docs/incident-2026-08-19.md — запись об инциденте

• tests/test_incident_2026_08_19.py — тест, воспроизводящий инцидент