Claude Context
저장소 전체를 벡터로 색인해 의미로 찾아 주는 코드 검색
npx @zilliz/claude-context-mcp@latest저장소 전체를 의미 기반으로 검색해 코딩 에이전트에게 필요한 코드만 넘겨 주는 MCP 서버입니다. 여러 번 탐색하며 파일을 뒤지는 대신 관련된 부분을 한 번에 찾아 맥락에 넣습니다. 큰 저장소에서 디렉터리를 통째로 밀어 넣으면 비용이 크게 붙는데, 이 도구는 코드를 벡터 데이터베이스에 저장해 두고 관련된 조각만 꺼내 씁니다. 임베딩 모델 키와 벡터 데이터베이스 접속 정보가 필요합니다. 클로드 코드 외에 여러 클라이언트용 설정 예시가 문서에 정리돼 있습니다.
판단
이럴 때 씁니다
- 저장소가 커서 관련 코드를 찾는 데 여러 차례를 쓰고 있을 때
- 디렉터리를 통째로 넣느라 비용이 커질 때
- 이름이 아니라 의미로 코드를 찾아야 할 때
이럴 땐 쓰지 마세요
- 작은 저장소에서는 문자열 검색이 빠릅니다
- 임베딩 키와 벡터 데이터베이스가 필요합니다
- 색인이 낡으면 결과가 실제 코드와 어긋납니다
차별점
- 의미 기반 검색으로 여러 차례 탐색을 한 번으로 줄입니다.
- 관련 조각만 맥락에 넣어 큰 저장소에서 비용을 줄입니다.
- 여러 코딩 도구용 설정 예시를 제공합니다.
워크플로
- 01임베딩 키와 벡터 데이터베이스 접속 정보를 준비합니다.
- 02MCP 서버를 등록합니다.
- 03저장소를 색인합니다.
- 04에이전트가 의미 기반 검색으로 관련 코드를 꺼내 씁니다.
- 05코드가 크게 바뀌면 색인을 갱신합니다.
주요 명령
| 명령 | 설명 |
|---|---|
claude mcp add claude-context -e OPENAI_API_KEY=... -e MILVUS_ADDRESS=... -- npx @zilliz/claude-context-mcp@latest | 임베딩 키와 벡터 데이터베이스 정보를 넣어 서버를 등록합니다. |
함정
설치 전에 확인하세요
- 임베딩 키와 벡터 데이터베이스가 둘 다 필요합니다. 둘 중 하나만 있으면 동작하지 않습니다.
- 코드가 벡터 데이터베이스로 나갑니다. 사내 코드라면 어디에 저장되는지 먼저 확인해야 합니다.
- Node.js 20 이상이 필요합니다.
- 색인이 자동으로 최신을 따라가지 않습니다. 큰 변경 뒤에는 다시 색인해야 결과가 맞습니다.
비교
코드 탐색 도구는 대체로 기호와 참조를 따라갑니다. 정확하지만 무엇을 찾을지 이름을 알아야 합니다. 이쪽은 의미로 찾기 때문에 이름을 모르는 상태에서 유리합니다. 대신 색인 인프라가 필요하고 코드가 외부로 나갑니다.
최근 변경
같은 팀이 마크다운 기반 기억 플러그인을 따로 내면서 저장소 상단에서 안내하고 있습니다. 이 도구 자체는 코드 검색에 집중합니다.