Skip to main content
Glama
rei-meta-mcp

rei-meta-mcp

by fc0web

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: MCP Discovery Server

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

meta_list_sources(object_name?: str)

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

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

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

вердикт

значение

coherent

отпечатки всех достижимых source совпадают

divergent

среди достижимых source есть расхождения

unreachable

достижимых source нет

single_source

достижим только один 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:

source

kind

состояние

rei-memory-local

sqlite

полный отпечаток (~/rei-memory-mcp/data/seed_kernel.db)

rei-ai-mcp-local

mcp_stdio

частичный отпечаток (запуск node dist/mcp/start-mcp.js как subprocess и вызов get_kernel_status)

rei-ai-remote

unreachable_placeholder

недоступен — заглушка; через remote-devices напрямую из Python не проверить — всегда unreachable

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

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 — тест, воспроизводящий инцидент

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