Chroma

메타데이터

항목	값
패키지명	`chroma-mcp-server` (PyPI)
Transport	stdio
카테고리	database
설치 방식	`uvx chroma-mcp-server`
필수 환경변수	없음 (ephemeral 모드)
선택 환경변수	`CHROMA_DATA_DIR`, `CHROMA_HOST`, `CHROMA_PORT`, `CHROMA_API_KEY`
공식 문서	https://github.com/chroma-core/chroma-mcp
최근 검증일	2026-03-21

설정 스니펫

{
  "mcpServers": {
    "chroma": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "chroma-mcp-server",
        "--client-type", "persistent",
        "--data-dir", "./chroma_data"
      ]
    }
  }
}

Cloud 모드: "args": ["chroma-mcp-server", "--client-type", "cloud", "--api-key", "${CHROMA_API_KEY}"] Ephemeral 모드: "args": ["chroma-mcp-server"] (메모리 전용, 재시작 시 데이터 소멸)

제공 도구

도구명	설명	Claude Code 호출
`chroma_create_collection`	컬렉션 생성 (임베딩 함수 선택 가능)	`mcp__chroma__chroma_create_collection`
`chroma_list_collections`	전체 컬렉션 목록 조회	`mcp__chroma__chroma_list_collections`
`chroma_get_collection_info`	컬렉션 상세 정보	`mcp__chroma__chroma_get_collection_info`
`chroma_delete_collection`	컬렉션 삭제	`mcp__chroma__chroma_delete_collection`
`chroma_add_documents`	문서 추가 (자동 중복 감지)	`mcp__chroma__chroma_add_documents`
`chroma_query_documents`	벡터/전문 검색 + 메타데이터 필터링	`mcp__chroma__chroma_query_documents`
`chroma_get_documents`	ID/필터 기반 문서 조회	`mcp__chroma__chroma_get_documents`
`chroma_delete_documents`	문서 삭제	`mcp__chroma__chroma_delete_documents`

사용 사례

RAG (Retrieval-Augmented Generation) 파이프라인의 벡터 저장소
프로젝트 문서/코드를 임베딩하여 시맨틱 검색
/kdyextract 추출 코드 메타데이터 벡터 검색
AI 에이전트의 장기 기억(Long-term Memory) 구현
임베딩 함수: default, cohere, openai, jina, voyageai, roboflow

주의사항

Python 기반: uvx (권장) 또는 pip install chroma-mcp-server 로 설치
[full] 옵션: pip install "chroma-mcp-server[full]" 로 모든 임베딩 모델 설치
Persistent 모드: --data-dir 경로에 데이터 영구 저장
Cloud 모드: api.trychroma.com에 연결 (API 키 필요)
HTTP 모드: 자체 호스팅 Chroma 인스턴스에 --host, --port 로 연결
발견일: 2026-03-21 | 출처: kdyintel Scout