# Mantic - AI 에이전트를 위한 구조적 코드 검색 엔진

> Clean Markdown view of GeekNews topic #25942. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=25942](https://news.hada.io/topic?id=25942)
- GeekNews Markdown: [https://news.hada.io/topic/25942.md](https://news.hada.io/topic/25942.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2026-01-19T09:46:02+09:00
- Updated: 2026-01-19T09:46:02+09:00
- Original source: [github.com/marcoaapfortes](https://github.com/marcoaapfortes/Mantic.sh)
- Points: 13
- Comments: 0

## Summary

**Mantic**은 AI 코드 어시스턴트의 **문맥 검색 속도 병목**을 해소하기 위해 설계된 구조적 코드 검색 엔진입니다. 파일 구조와 메타데이터를 기반으로 의도를 추론하며, **벡터 DB나 외부 API 없이도 500ms 이하의 검색 속도**를 유지합니다. 대규모 모노레포에서도 일관된 성능을 제공하고, MCP 서버로 동작해 Claude Desktop·Cursor·VS Code 등과 자연스럽게 통합됩니다. 로컬 우선 설계와 결정적 점수화 방식으로 토큰 사용량을 줄이면서도 검색 품질을 유지하는 점이 특징입니다.

## Topic Body

- AI 코드 어시스턴트의 **문맥 검색 속도 문제**를 해결하기 위해 개발된 **Structural 코드 검색 엔진**  
- **파일 구조와 메타데이터**를 분석해 의도를 추론하고, **500ms 이하의 검색 속도**를 달성  
- **임베딩, 벡터 데이터베이스, 외부 API** 없이 동작하는 **로컬 우선(Local-First)** 설계  
- 대규모 모노레포(예: Chromium 48만 개 파일)에서도 **일관된 검색 성능** 제공  
- **Git 기반 파일 스캐닝**으로 추적 파일을 우선 처리하고, **결정적 점수화(Deterministic Scoring)** 방식 적용  
- **MCP(Model Context Protocol)** 서버로 작동해 **Claude Desktop, Cursor, VS Code** 등과 통합 지원  
- Impact Analysis 기능으로 코드 변경 시 영향 범위(Blast Radius) 분석 지원  
- Scoped Search 옵션(`--path`)으로 특정 디렉터리 내 검색 제한 가능  
- 코드/테스트/설정 파일 구분 검색 등 세분화된 CLI 옵션 제공  
- 0.3~0.4초 수준의 검색 지연으로 벡터 검색 대비 최대 **25배 빠른 성능**  
- **토큰 사용량 최대 63% 절감**, 불필요한 파일 접근 최소화  
- 환경 변수 기반 설정: 파일 수, 타임아웃, 무시 패턴 등 제어 가능  
- AGPL-3.0 및 상용 라이선스의 이중 라이선스 구조  
  - 내부 사용 및 오픈소스 통합은 무료  
  - 상용 IDE, SaaS 통합 시 별도 라이선스 필요  
- **TypeScript 기반**으로 개발되었으며, **npm 패키지(mantic.sh)** 형태로 배포  
- **AI IDE 통합 규칙(Agent Rules)** 을 통해 Claude나 Cursor가 자동으로 Mantic을 호출하도록 설정 가능

## Comments



_No public comments on this page._