Skip to main content
Glama
rei-meta-mcp

rei-meta-mcp

by fc0web

rei-meta-mcp

Capa meta que se sitúa sobre el conjunto de conectores. Considera cada conector MCP un objeto y la ruta de acceso a ese objeto como un morfismo, y maneja esa estructura.

El único propósito práctico de la Fase 1 es la comprobación de coherencia (coherence check): cotejar mecánicamente si el contenido coincide entre varias fuentes que apuntan al mismo objeto.

Por qué se creó

El 19 de agosto de 2026, durante la implementación de rei-memory-mcp, se descubrió que SEED_KERNEL llevaba 11 días desviado en 1,677 vs 1,675 sin que nadie se hubiera dado cuenta. Solo se notó porque una persona comparó por casualidad las dos cifras; la máquina no tenía ningún medio de detección.

La primera tarea de este conector es que la máquina lo detecte antes que nadie. Detalles en docs/incident-2026-08-19.md.

Related MCP server: MCP Discovery Server

Herramientas proporcionadas (3)

meta_list_sources(object_name?: str)

Enumera las fuentes registradas y devuelve el estado de alcance, el recuento y el hash del git HEAD de cada una (indicio de frescura).

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

Compara las huellas de las fuentes que apuntan al mismo objeto y devuelve un veredicto entre los siguientes:

verdict

significado

coherent

Coinciden las huellas de todas las fuentes alcanzadas

divergent

Hay discrepancias entre las fuentes alcanzadas

unreachable

Se alcanzó cero fuentes

single_source

Solo se alcanzó una fuente (imposible comparar)

§4 rule central: «no alcanzado» no es «coincidido». unreachable y single_source siempre se muestran como advertencia.

Con detail=True devuelve la lista real de IDs en discordancia (máximo 100).

meta_compose(state: from_source: str, to_source: str)

En la Fase 1 solo se compara las cadenas de texto output_schema / input_schema dentro del registro. La inferencia real del esquema es de la Fase 3 en adelante.

Lo que no se hace en la Fase 1

  • Reparación automática (exclusión deliberada: la decisión correcta la toma una persona)

  • Persistencia del historial de inspección (Fase 2)

  • Inferencia de esquema (Fase 3)

  • Construcciones de la teoría de categorías como funtores, adjunciones y mónadas (cuando sea necesario)

Fuentes registradas actualmente

Consultar config/sources.example.yaml:

source

kind

estado

rei-memory-local

sqlite

huella completa (~/rei-memory-mcp/data/seed_kernel.db)

rei-aios-local-mcp

mcp_stdio

huella parcial (lanzar node dist/mcp/start-mcp.js como subprocess y llamar a get_kernel_status).

rei-aios-remote

unreachable_placeholder

el despliegue mediante remote-devices de claude.ai no se puede sondear directamente desde Python; siempre se indicará explícitamente unreachable.

Instalación y uso

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

La ruta del registro se puede sobreescribir con la variable de entorno REI_META_MCP_REGISTRY.

Alcance honesto

  1. Detect only, do not repair — la decisión no se saca del ámbito del humano.

  2. Un offender partial fingerprint (mcp_stdio) solo confirma que no hay diferencias, no constituye una prueba de «coincidencia total» (hay partes que no se ven a nivel de content_hash).

  3. Solo cinco conceptos de teoría de categorías tienen peso propio: objeto, morfismo, igualador, composición e identidad. Evitamos el resto.

  4. Seres el actual es un spike de la Fase 1 con 3 fuentes; la estructura gana valor cuantos más objetos haya.

  5. La Fase 2 (historial, ejecución periódica, notificación) y la Fase 3 (inferencia de esquema, generalización de morfismos) se decidirán cuando la Fase 1 funcione en producción real.

Licencia

AGPL-3-3.0-or-later.

Relacionados

  • docs/incident-2026-08-19.md — registro del incidente

  • tests/test_incident_2026_08_19.py — prueba que reproduce el incident

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