rei-memory-mcp

Rei / Claude가 전체 텍스트 검색, ID 또는 STEP을 통해 Rei-AIOS SEED_KERNEL(2026-08-19 기준 1,677개 이상의 이론)을 조회할 수 있게 해주는 읽기 전용 MCP 서버입니다.

1단계 — 읽기 전용. 쓰기 경로는 MCP 도구로 노출되지 않습니다. 수집은 일회성 스크립트이며, 이론 추가 및 승격은 2단계(seed_propose 스테이징 테이블)에 속합니다.

설계 원칙

3계층 분류(proven / hypothesis / speculative)는 필수 스키마 필드입니다. 계층이 없는 이론은 수집할 수 없습니다. 전염병 위생 규율은 사람의 주의가 아닌 스키마에 의해 강제됩니다.

Related MCP server: Ek-Chuah MCP

도구

설정

Python 3.11+ 및 SQLite 3.34+(FTS5 트라이그램 토크나이저용 — Python 3.11+에 번들됨).

# from repo root
python -m venv .venv
.venv/Scripts/activate            # Windows
source .venv/bin/activate         # Unix
pip install -e '.[dev]'

데이터베이스 구축

SEED_KERNEL은 rei-aios/src/axiom-os/seed-kernel*.ts에 TypeScript 소스로 존재합니다. JSONL로 덤프한 후 수집합니다:

# 1. dump (run inside the rei-aios repo; script is bundled there)
cd path/to/rei-aios
npx tsx scripts/dump-seed-kernel-json.ts > /path/to/rei-memory-mcp/data/seed-kernel-dump.jsonl

# 2. ingest into SQLite
cd path/to/rei-memory-mcp
python scripts/ingest.py \
    --input data/seed-kernel-dump.jsonl \
    --db    data/seed_kernel.db

data/*.jsonl과 data/*.db는 모두 gitignore 처리되어 있습니다 — 필요에 따라 재생성하세요.

MCP 서버 실행

# stdio transport (default)
python -m rei_memory_mcp.server
# or via console script:
rei-memory-mcp

DB 경로는 REI_MEMORY_DB에서 가져옵니다(기본값: ./data/seed_kernel.db).

Claude Desktop 구성

Claude Desktop MCP 설정에 추가하세요(경로 조정 필요):

{
  "mcpServers": {
    "rei-memory": {
      "command": "python",
      "args": ["-m", "rei_memory_mcp.server"],
      "cwd": "C:/Users/user/rei-memory-mcp",
      "env": {
        "REI_MEMORY_DB": "C:/Users/user/rei-memory-mcp/data/seed_kernel.db"
      }
    }
  }
}

테스트

pytest

일본어 쿼리 테스트(test_search.py::test_japanese_query_hits)가 핵심 신호입니다 — 이 테스트가 실패하면 트라이그램 토크나이저가 손상된 것이며 검색은 조용히 쓸모없게 됩니다.

정직한 범위

• 읽기 전용. 쓰기 MCP 도구는 의도적으로 존재하지 않습니다. 잘못된 기억이 형태를 갖추는 빠른 경로가 되어서는 안 됩니다.

• 트라이그램 일본어. 2자 이하의 쿼리는 일본어 텍스트와 일치하지 않습니다(트라이그램 토크나이저의 작동 방식입니다). 3자 이상의 쿼리를 사용하세요.

• STEP 적용 범위. 현재 SEED_KERNEL 항목의 약 3%만 본문 텍스트에 STEP N 마커를 포함합니다. seed_list_steps는 이를 충실히 보고합니다.

• ID 형태. 현재 SEED_KERNEL은 세 가지 ID 패턴(T-\d+, invented-*, 케밥-케이스 슬러그)을 혼용합니다. 세 가지 모두 허용되며 재구성하지 않습니다.

• 벡터 검색 없음. FTS5 트라이그램이 1단계의 전체 검색 방식입니다. 이것이 불충분한 것으로 판명되면, 2단계에서 임베딩을 대체가 아닌 병행으로 추가할 수 있습니다.

로드맵(구현되지 않음)

• 2단계 — seed_propose 스테이징 테이블 + 인간 승인 → theories로 승격. theories에 대한 직접 쓰기는 도구로 노출되지 않습니다.

• 3단계 — 승격 이력 테이블을 통해 이론의 궤적(hypothesis → proven) 자체가 하나의 산출물이 됩니다.

• 4단계 — 랭킹을 위한 접근 횟수 감쇠. immutable: true 행은 면제되며, 어떤 것도 삭제되지 않습니다.

라이선스

AGPL-3.0(상업용 이중 라이선스 조건 포함 — LICENSE 참조). rei-aios 메인 저장소와 일치합니다.

急がず、ゆっくりと。種は育ちます。