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: Code-Oracle

제공하는 tool (3개)

meta_list_sources(object_name?: str)

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

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

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

§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 참조:

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 — 사고를 재현하는 테스트