🌌 STRATA — 유니버설 컨텍스트 브리지

STRATA는 AI 어시스턴트 및 LLM 에이전트(Claude Desktop, Cursor, Continue.dev, ChatGPT 등)를 위한 유니버설 컨텍스트 브리지 역할을 하는 고성능 Model Context Protocol (MCP) 서버입니다.

Supabase PostgreSQL, 전문(full-text) 인덱싱, pgvector 의미 검색을 기반으로 AI 모델이 대화 및 코딩 세션 전반에 걸쳐 지속적인 메모리를 유지할 수 있도록 지원합니다.

⚡ 기능

• 🧠 지속적 컨텍스트 메모리: AI 에이전트가 세션 간에 결정 사항, 디자인 시스템, API 계약, 선호 사항, 코드 스니펫을 저장할 수 있습니다.

• 🔍 지능형 메모리 검색: 자동 최신성 폴백을 지원하는 빠른 전문 및 상황별 검색.

• 🚀 최신 MCP 2.0 SDK: Server-Sent Events (SSE) 스트리밍 전송을 지원하는 최신 MCPServer 데코레이터 아키텍처로 구축.

• 🗄️ Supabase 및 PostgreSQL: pgvector 지원 및 행 수준 보안(RLS)을 갖춘 검증된 클라우드 데이터베이스 계층.

• 🔄 싱글톤 연결 풀링: 높은 처리량과 낮은 지연 시간의 도구 실행을 위한 캐시된 클라이언트 인스턴스.

• 🩺 내장 상태 확인: 가동 시간 모니터링 및 연결 상태 확인을 위한 REST 엔드포인트(/health).

Related MCP server: memory-mcp

🛠️ 사용 가능한 MCP 도구

🚀 빠른 시작

1. 사전 요구 사항

• Python 3.10 이상

• Supabase 계정 및 프로젝트

2. 저장소 복제 및 환경 설정

# Clone the repository
git clone https://github.com/your-username/STRATA.git
cd STRATA

# Copy environment file and configure your keys
cp .env.example .env

.env 파일을 Supabase 자격 증명으로 편집하세요:

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_KEY=your-supabase-service-role-key
DEFAULT_USER_ID=your-user-uuid (optional)

3. 종속성 설치

cd apps/api
python -m venv venv

# Activate virtual environment:
# Windows (PowerShell):
.\venv\Scripts\Activate.ps1
# macOS / Linux:
source venv/bin/activate

# Install requirements
pip install -r requirements.txt

4. 데이터베이스 설정

supabase_schema.sql에 있는 SQL 스키마를 Supabase SQL Editor에서 실행하여 테이블, 벡터 확장, 전문 인덱스를 초기화하세요.

5. 서버 시작

# From apps/api directory:
uvicorn main:app --reload --port 8000

서버는 http://localhost:8000에서 시작되며 다음 엔드포인트를 제공합니다:

• SSE 엔드포인트: http://localhost:8000/sse

• 메시지 엔드포인트: http://localhost:8000/messages/

• 상태 확인: http://localhost:8000/health

🔌 MCP 클라이언트에 연결

Claude Desktop

claude_desktop_config.json에 다음을 추가하세요:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "strata": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Cursor IDE

Cursor 설정의 Features > MCP Servers에서 새 서버를 추가하세요:

• 이름: STRATA

• 유형: sse

• URL: http://localhost:8000/sse

📁 프로젝트 구조

STRATA/
├── apps/
│   └── api/                   # Python MCP Server
│       ├── main.py            # Server logic, MCPServer instance & tools
│       ├── requirements.txt   # Python dependencies
│       └── venv/              # Python virtual environment
├── .env.example               # Template environment file
├── .gitignore                 # Version control ignores
├── package.json               # Root monorepo configuration
├── supabase_schema.sql        # Database schema, pgvector, and indexes
└── README.md                  # Documentation

🛡️ 라이선스

MIT 라이선스. 자세한 내용은 LICENSE를 참조하세요.