ONEDEV

claude-context

AI Coding ToolsCLITypeScript

★ 12,518주당 +31조회 5

무엇인가

claude-context는 코딩 에이전트와 코드베이스 사이에 놓이는 검색 계층이다. MCP(Model Context Protocol) 서버로 구현되며, 에이전트가 파일 트리를 직접 순회하는 대신 자연어 질의를 보내면 관련 코드 조각을 돌려받는 구조다. 저장소 전체를 프롬프트에 넣는 방식과 grep·파일 열기를 반복해 위치를 좁히는 방식을 모두 대체한다.

어떻게 동작하나

동작은 인덱싱과 검색 두 단계로 나뉜다. 인덱싱 단계에서 코드베이스를 조각내 OpenAI 임베딩 모델로 벡터화하고 Milvus 기반 벡터 데이터베이스(Zilliz Cloud)에 저장한다. 검색 단계에서 에이전트가 MCP 도구를 호출하면 벡터 유사도로 관련 코드를 찾아 반환한다. 서버는 stdio transport로 동작하며 표준 MCP 프로토콜을 따른다.

무엇과 다른가

차이는 컨텍스트에 들어가는 코드의 양에서 나온다. 디렉터리 전체를 매 요청마다 넣는 방식은 입력 토큰이 코드베이스 크기에 비례해 늘어난다. claude-context는 벡터 DB에서 질의와 가까운 조각만 꺼내므로 입력 토큰이 저장소 크기가 아니라 질의 관련도에 좌우된다. 여러 라운드에 걸쳐 파일을 찾아 헤매는 탐색 루프도 한 번의 시맨틱 검색으로 줄인다.

어떻게 쓰나

설정은 MCP 클라이언트마다 파일 형식만 다르고 내용은 같다. 서버 실행 명령은 npx -y @zilliz/claude-context-mcp@latest이고, 환경 변수로 OPENAI_API_KEY, MILVUS_ADDRESS, MILVUS_TOKEN을 넘긴다. Claude Code는 CLI로 서버를 등록하고, Codex CLI는 ~/.codex/config.toml, Gemini CLI는 ~/.gemini/settings.json, Cursor는 ~/.cursor/mcp.json, Cline은 cline_mcp_settings.json에 항목을 추가한다. Claude Desktop, Windsurf, VS Code, Void, Cherry Studio, Augment, Zencoder도 같은 방식으로 붙는다.

전제와 한계

전제 조건은 Node.js 20.0.0 이상이다. 벡터 저장소로 Zilliz Cloud 주소와 API 키가, 임베딩 생성에 OpenAI API 키가 필요하다. 로컬에서 완결되지 않고 외부 임베딩 API와 외부 벡터 DB에 의존한다. 클라이언트 쪽은 stdio transport를 지원하는 MCP 호스트여야 한다.

관련 논문 1

유사 도구