Skip to main content
Glama
rei-meta-mcp

rei-meta-mcp

by fc0web

rei-meta-mcp

커넥터 군 위에 서는 메타 계층. 개별 MCP 커넥터를 대상, 대상에 대한 접근 경로를 사상으로 간주하고, 그 구조를 다룬다.

Phase 1의 유일한 실용 목적은 정합성 검사(coherence check) — 같은 대상을 가리키는 여러 소스 간에 내용이 일치하는지를 기계적으로 대조하는 것이다.

왜 만들었는가

2026-08-19, rei-memory-mcp의 구현 과정에서 SEED_KERNEL이 1,677 vs 1,675로 11일간 어긋난 채 발견되지 않았던 것이 판명되었다. 발견할 수 있었던 것은 인간이 두 숫자를 우연히 서로 비교했기 때문이며, 기계에는 검출 수단이 없었다.

이 커넥터의 첫 번째 일은, 이것을 기계가 먼저 찾아내는 것이다. 자세한 내용은 docs/incident-2026-08-19.md를 참조.

Related MCP server: MCP Discovery Server

제공하는 tool (3개)

meta_list_sources(object_name?: str)

등록된 source를 열거하고, 각각의 도달 상태·건수·git HEAD 해시(freshness의 단서)를 반환한다.

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

같은 대상을 가리키는 source의 지문을 대조하여, 다음 중 하나의 verdict를 반환한다:

verdict

의미

coherent

도달 가능한 전체 source의 지문 일치

divergent

도달 가능한 source 간 불일치

unreachable

도달 가능한 source가 0개

single_source

도달 가능한 source가 1개뿐 (비교 불가)

§4 중핵 규칙: 「도달하지 못함」은 「일치함」이 아니다. unreachable과 single_source는 항상 경고로 surface된다.

detail=True로 불일치 ID의 실제 목록(최대 100건)을 반환한다.

meta_compose(from_source: str, to_source: str)

Phase 1은 registry 내의 output_schema / input_schema 문자열 대조만 수행한다. 실제 스키마 추론은 Phase 3 이후.

Phase 1에서 하지 않는 일

  • 자동 수복 (의도적 제외. 어느 쪽이 올바른지의 판단은 인간이 수행)

  • 검사 이력의 영속화 (Phase 2)

  • 스키마 추론 (Phase 3)

  • 함자·수반·모나드 등의 범주론 구성 (필요해졌을 때)

현재 시점의 registered source

config/sources.example.yaml 참조:

source

kind

상태

rei-memory-local

sqlite

full fingerprint (~/rei-memory-mcp/data/seed_kernel.db)

rei-aios-local-mcp

mcp_stdio

partial fingerprint (node dist/mcp/start-mcp.js를 subprocess로 기동하여 get_kernel_status를 호출)

rei-aios-remote

unreachable_placeholder

claude.ai remote-devices 경유 deploy는 Python에서 직접 probe 불가 — 항상 unreachable을 명시

Install & 사용

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

registry의 경로는 환경 변수 REI_META_MCP_REGISTRY로 덮어쓰기 가능.

Honest scope

  1. 검출만, 수복은 하지 않음 — 판단을 인간의 밖으로 내보내지 않음

  2. partial fingerprint의 source (mcp_stdio) 간의 일치는 「불일치가 없음」의 확인이지 「완전 일치」의 증명은 아님 (content_hash 레벨에서 볼 수 없는 부분이 있음)

  3. 범주론 용어는 5개만 (대상·사상·등화자·합성·항등 사상) 하중을 짊어짐. 그 외는 피함

  4. 현 상태 3 source의 Phase 1 spike. 대상이 늘수록 가치가 커지는 구조

  5. Phase 2 (이력·정기 실행·통지)와 Phase 3 (스키마 추론·사상의 일반화)는, Phase 1이 실운용에서 기능한 후에 판단

License

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