Claude Context — 코드베이스 전체를 MCP 컨텍스트로 주입하는 시맨틱 코드 검색

코드베이스 전체를 벡터화해 두고, 필요한 코드만 에이전트 컨텍스트에 넣는 MCP형 semantic code search.

개요

zilliztech/claude-context는 Claude Code와 기타 AI 코딩 에이전트를 위한 semantic code search MCP다. 핵심 아이디어는 전체 저장소를 벡터 데이터베이스에 색인한 뒤, 매 턴마다 디렉토리를 다시 훑는 대신 관련 코드 조각만 에이전트 컨텍스트에 주입하는 것이다.

핵심 구조

  • @zilliz/claude-context-core: 색인/임베딩/벡터 DB 연동
  • @zilliz/claude-context-mcp: MCP 서버
  • Milvus / Zilliz Cloud 기반 벡터 저장소
  • OpenAI 임베딩 API 등 외부 임베딩 공급자 필요

실무적 의미

이 프로젝트는 단순 grep 대체가 아니라, 거대한 코드베이스를 에이전트가 실제로 다룰 수 있게 만드는 retrieval layer에 가깝다. 즉 토큰 절감, 대형 코드베이스 탐색 단축, multi-round discovery 감소가 핵심 가치다.

지원 클라이언트

README 기준으로 다음 MCP 클라이언트 설정 예시를 제공한다.

  • Claude Code
  • Codex CLI
  • Gemini CLI
  • Qwen Code
  • Cursor
  • Claude Desktop
  • Windsurf / VS Code 등

한계

  • Node.js 20~23 환경 필요
  • 벡터 DB와 임베딩 API 키가 필요해 설정 비용이 있다
  • retrieval 품질은 chunking, embedding, index 상태에 크게 좌우된다

관점 해석

이건 2026-04-22-openai-workspace-agents-chatgpt 같은 조직형 agent runtime과는 다른 층이다. Claude Context는 에이전트 자체가 아니라 에이전트의 코드 컨텍스트 공급 계층이다. 코드베이스가 커질수록 중요성이 커진다.