# Maguyva가 돌아가는 기반

Canonical source: https://maguyva.ai/ko/stack

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

속도, 디버깅 용이성, 지속적인 개선을 위해 만들어졌습니다: 핵심에는 검증된 인프라를, 코드 인텔리전스가 필요한 곳에는 전용으로 설계된 컴포넌트를 사용합니다.

- PostgreSQL + Lance
- 양자화된 벡터 검색
- 코드 언어 엔진
- 어디서나 MCP
- 285개 이상의 언어

## 프로덕션에서 돌아가는 것

여러 차례의 반복 개발 끝에 남은 핵심 레이어들입니다. 각각은 디버깅을 더 쉽게 만들거나 에이전트 실행의 마찰을 줄임으로써 그 자리를 지켰습니다.

### PostgreSQL + Lance

*데이터베이스*

테넌트 단위로 분할된 스토리지와 인덱스입니다. 여러분의 코드는 격리된 상태로 유지되며, 사용자 간 인덱스가 섞이지 않습니다.

### Voyage AI: voyage-4-large

*임베딩*

에이전트 검색, 조회, 그라운딩을 위한 높은 재현율의 코드 임베딩입니다.

### Binary Quantized HNSW

*벡터 검색*

임베딩을 2048비트 시그니처로 압축해 HNSW로 인덱싱합니다. 스토리지 사용량은 기존의 1/32로 줄고, 검색 지연 시간은 낮으며, 추가 인프라는 필요 없습니다.

### 코드 언어 엔진

*언어 엔진*

커스텀 문법, 핸들러 휴리스틱, 285개 언어 추출 커버리지를 갖춘 대폭 수정된 Tree-sitter 스택입니다

### MCP 프로토콜

*프로토콜*

Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop 및 기타 MCP 호환 클라이언트용 원격 MCP 서버입니다. TypeScript Cloudflare Worker에서 11개 도구와 네이티브 streamable HTTP 전송을 제공합니다.

### Lance 컬럼형 + R2

*캐시*

컬럼 기반으로 캐시되고 클라우드와 동기화되는 임베딩

## 막다른 길들을 지나온 스택

Maguyva는 한 번에 지금의 형태에 도달하지 않았습니다. 각 레이어는 시스템을 더 쉽게 이해하게 만들거나, 운영 비용을 낮추거나, 압박 속에서도 더 쉽게 디버깅하게 만들었기 때문에 살아남았습니다.

오케스트레이션 실험은 더 일찍 시작됐습니다. 이 타임라인은 Maguyva 제품 자체가 명확한 방향을 잡은 2025년 9월부터 시작합니다.

- **2025-Q3** (기반): 집중적인 Maguyva 빌드 시작 → Voyage voyage-code-3. 제품 방향이 확고해지고 빠른 반복 개발 루프가 시작됩니다
- **2025-Q3** (스토리지): 이진 벡터 조회 레이어. 압축 인덱스를 사용한 양자화 검색, 별도의 벡터 스택 없음
- **2025-Q4** (AST 엔진): 코드 언어 엔진 가동 시작. 285개 언어 전반에 걸친 커스텀 쿼리, 파서 폴백, 핸들러 기반 휴리스틱
- **2025-Q4** (검색): 멀티모달 융합 검색. 단일 쿼리로 시맨틱, 텍스트, AST, 그래프 인덱스 전반에서 순위화된 결과를 조회합니다
- **2026-Q1** (캐싱): Lance 컬럼형 + R2 동기화. 서버 측 컬럼 캐시로 콜드 스타트가 더 빨라집니다
- **2026-Q1** (품질): 285개 언어 검증 프레임워크. 지원되는 모든 언어에 걸친 자동화된 추출 테스트
- **2026-Q1** (출시): maguyva.ai에서 공개 출시. 집중 빌드 시작부터 공개 출시까지 7개월
- **2026-Q2** (프로토콜): TypeScript Cloudflare Worker 기반 MCP. 네이티브 streamable HTTP 전송, 더 낮은 지연 시간, 실제 트래픽에서 교체 완료
- **NOW** (임베딩): 프로덕션 임베딩 → voyage-4-large. voyage-code-3에서 전환한 뒤 재현율이 높아진 시맨틱 검색

## 저희는 저희가 출시한 것 위에서 돌아갑니다

Maguyva는 Maguyva 위에서 돌아가는 에이전트들이 만듭니다.

저희 오케스트레이션 시스템은 여러분과 동일한 MCP 도구, 검색 인덱스, 프로덕션 인프라를 사용하는 전문 AI 에이전트들을 조율합니다. 내부용 별도 버전은 없습니다. 팀 페이지에는 “1x Maguyva ($149) — 저희가 저희 자신에게 지불합니다.”라고 적혀 있습니다. 농담이 아닙니다. 실제 청구서입니다.

// 고객 제로는 매일 프로덕션에 배포합니다

## 프로덕션에서 살아남은 규칙들

프로덕션에서 계속 유용했던 제약들입니다. 이념보다는, 에이전트가 빠른 속도로 변경을 가하는 와중에도 시스템을 이해 가능한 상태로 유지하는 것에 관한 것입니다.

### 조용한 폴백 없음

빠르게 실패하고, 빠르게 고칩니다. 모든 오류는 즉시 드러납니다. 프로덕션에서 버그를 숨기는 우아한 성능 저하 같은 건 없습니다.

*// 패닉 > 조용한 손상*

### RPC 우선

성능을 위한 데이터베이스 측 로직입니다. PostgreSQL 함수가 데이터 가까이에서 실행되어 왕복 통신을 없앱니다.

*// PostgreSQL 함수, ORM 0개*

### CQRS

쓰기와 읽기 경로를 분리합니다. 인덱싱 파이프라인이 쓰고, MCP 도구가 읽습니다. 최적화 전략이 서로 다릅니다.

*// 쓰기: 배치 처리 | 읽기: 캐시됨*

### 결정론적 UUID

데이터베이스 조회 없이도 캐시 일관성을 유지합니다. 같은 입력 = 같은 ID. 설계상 멱등적인 연산입니다.

*// uuid5(namespace, content_hash)*

최고의 아키텍처는 새벽 3시에도 디버깅할 수 있는 아키텍처입니다. (직접 검증해봤습니다.)

// 마지막 업데이트: 2026-10

[여러분의 저장소에서 써보기](https://app.maguyva.ai/auth/sign-up?plan=free)

## 여러분의 코드가 있는 곳

숨기는 것 없습니다. 저장소를 연결하면 여러분의 코드에 정확히 무슨 일이 일어나는지 알려드립니다.

- **베어메탈 서버, 미국 동부** (컴퓨트): 애슈번(Ashburn)에 위치한 베어메탈 머신으로, 리소스 간섭이 있는 범용 인스턴스 대신 인덱싱 처리량에 맞춰 튜닝되어 있습니다.
- **Cloudflare 글로벌 CDN** (엣지): API와 MCP 응답은 엣지에서 캐시됩니다. 정적 자산은 Cloudflare의 글로벌 네트워크에서 제공됩니다.
- **워크스페이스별 테넌트 분할** (격리): 각 워크스페이스는 파이프라인과 데이터베이스 전반에서 테넌트 단위로 범위가 지정된 저장소 인덱스를 갖습니다. 저희는 고객 코드를 코드 인텔리전스 제공에만 사용하며, 모델 학습이나 데이터 판매에는 사용하지 않습니다.
- **싱가포르 법인** (법인): UT International PTE. LTD. 실제 관할권, 실제 법인입니다.
- **저장소를 제거하면, 인덱스도 제거됩니다** (삭제): 저장소 연결을 해제하면 Maguyva는 활성 인덱싱된 소스 코드, 임베딩, 그래프 데이터를 서비스에서 삭제합니다. 잔여 백업은 보관 일정에 따라 만료됩니다.
- **EU나 AU 리전이 필요하신가요?** (리전): 데이터 상주 요건이 있는 고객을 위한 추가 배포 리전은 별도로 논의 가능합니다.

## 다음 단계

- [시작하기](https://maguyva.ai/ko/docs): 몇 분 만에 첫 저장소를 인덱싱하세요.
- [요금제 보기](https://maguyva.ai/ko/pricing): 사용자 단위가 아닌 워크스페이스 단위 과금. 무료로 시작하세요.
- [팀 소개](https://maguyva.ai/ko/team): 인간 2명과 AI 에이전트 무리.
- [블로그 읽기](https://maguyva.ai/ko/blog): 빌드 과정의 기술 노트.