Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
KotaDB는 Claude Code가 사용자의 코드베이스 구조를 깊이 이해하도록 돕는 로컬 코드 인텔리전스 도구입니다. 저장소를 인덱싱하여 의존성 분석, 의미 기반 코드 검색 등을 제공하며, 모든 작업이 로컬에서 실행되어 높은 보안성을 보장합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Codex tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기Claude에게 코드를 질문하세요. 즉각적인 답변을 받으세요.
KotaDB는 Claude Code가 사용자의 코드베이스를 이해할 수 있도록 강력한 기능을 제공합니다. 저장소(repository)를 한 번 인덱싱하면, *"이 파일을 변경하면 무엇이 깨지나요?"*와 같은 질문을 하고 정확하고 의존성을 고려한 답변을 받을 수 있습니다.
KotaDB는 Claude Code가 코드베이스 구조를 이해하도록 돕는 로컬 코드 인텔리전스 도구입니다:
전제 조건: Bun v1.1 이상 (필수)
단계 1: Claude Code에 추가하기
다음 내용을 Claude Code MCP 설정 파일(~/.claude/mcp.json)에 추가하세요:
{
"mcpServers": {
"kotadb": {
...
단계 2: 질문하기 시작하기
그냥 질문만 하세요! KotaDB는 첫 사용 시 자동으로 인덱싱됩니다:
"src/index.ts에 의존하는 파일은 무엇인가요?"
KotaDB가 코드베이스를 자동으로 인덱싱하고 질문에 답변합니다. 수동 설정이 필요 없습니다.
인덱싱이 완료되면, Claude는 다음과 같은 질문에 답변할 수 있습니다:
| 질문 | KotaDB 도구 |
|---|---|
| "이 파일을 변경하면 무엇이 깨지나요?" | search_dependencies |
| ... |
KotaDB는 HTTP 포트 대신 stdio (표준 입출력, standard input/output)를 사용합니다:
KotaDB는 --toolset 플래그를 통해 다양한 도구 계층을 지원합니다:
| 티어 (Tier) | 도구 (Tools) | 설명 (Description) |
|---|---|---|
core | 6 | 필수 코드 지능 (검색, 인덱싱, 의존성) |
| ... |
예시 구성:
bunx kotadb@next --stdio (기본값: 8개 도구)bunx kotadb@next --stdio --toolset core (최소화: 6개 도구)bunx kotadb@next --stdio --toolset memory (메모리 포함: 14개 도구)bunx kotadb@next --stdio --toolset full (전체: 20개 도구)KotaDB는 제가 AI 기반 개발자 도구를 구축하는 여정의 일부입니다. 저는 배운 모든 것을 공유합니다:
🎥 YouTube - Claude Code, MCP 및 이와 같은 도구 구축에 대한 튜토리얼
→ youtube.com/@jaymin-west
👥 Prompt to Prod Community - 단순히 프롬프트를 넘어 AI 앱을 출시하는 법 학습
→ skool.com/prompt-to-prod
Jaymin West가 제작했습니다.
# 의존성 설치
cd app && bun install
...
서버는 기본적으로 포트 3000에서 수신합니다. PORT=4000으로 재정의할 수 있습니다.
데이터는 기본적으로 ~/.kotadb/kotadb.sqlite에 저장됩니다.
cd app && bun --watch src/index.ts - 서버를 워치 모드(watch mode)로 시작합니다.cd app && bun test - 테스트 스위트를 실행합니다.cd app && bunx tsc --noEmit - 프로젝트의 타입 검사(Type-check)를 수행합니다.자세한 개발 환경 설정은 DEVELOPMENT.md를 참조하세요.
app/ # 애플리케이션 계층 (TypeScript/Bun API 서비스)
src/
api/ # HTTP 라우트 및 데이터베이스 접근
...
KotaDB는 Model Context Protocol을 통해 다음 도구들을 제공합니다:
| 도구 (Tool) | 목적 (Purpose) |
|---|---|
search_code | 인덱싱된 코드 파일에서 특정 용어를 검색합니다. |
| ... |
GET /health - 하트비트(Heartbeat) 엔드포인트입니다.POST /index - 인덱싱을 위한 저장소 큐잉(Queueing) 요청입니다.GET /search?term=foo - 특정 용어(term)를 포함하는 파일을 검색합니다.GET /files/recent - 최근 인덱싱 결과를 가져옵니다.다중 클라이언트 시나리오 또는 원격 접속의 경우, HTTP 전송을 사용하십시오:
{
"mcpServers": {
"kotadb": {
...
--port를 사용하여 포트를 사용자 정의할 수 있습니다:
kotadb --port 4000
엔드포인트: POST /mcp
필수 헤더:
Accept: application/json, text/event-streamMCP-Protocol-Version: 2025-06-18Content-Type: application/json예시: 초기 핸드셰이크(Initialize Handshake)
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
...
예시: 종속성 검색(Search Dependencies)
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
...
KotaDB v2.0.0은 .kotadb/ 디렉터리에 프로젝트 로컬 스토리지(project-local storage)를 사용하여 프로젝트 간 자동 격리를 제공합니다. 모든 MCP 도구는 결과를 필터링하기 위한 선택적 repository 매개변수를 지원합니다.
// 최근 파일 전체 목록 보기
await tools.list_recent_files({ limit: 20 });
...
자세한 지침은 docs/guides/multi-repo-best-practices.md를 참조하십시오.
기본적으로 KotaDB는 로컬호스트(localhost) 출처에서 오는 요청만 허용합니다. 필요한 경우 KOTA_ALLOWED_ORIGINS 환경 변수(쉼표로 구분)를 구성하십시오.
인덱서는 localPath가 제공되지 않으면 자동으로 리포지토리를 복제(clone)합니다. GitHub 클론 소스는 KOTA_GIT_BASE_URL을 사용하여 재정의할 수 있습니다.