MCP 서버와 ChromaDB 연결 문제 해결기

문제 상황

Model Context Protocol(MCP) 서버와 ChromaDB를 연동하는 과정에서 발생한 여러 오류들과 그 해결 과정을 정리했습니다.

1. 가상환경 문제

에러

spawn C:\Users\kub84\project\mcp-project\mcp-usecase\.venv\Scripts\python.exe ENOENT

해결

# 가상환경 생성 및 활성화
python -m venv .venv
.\.venv\Scripts\activate  # PowerShell에서는 실행 정책 문제 발생 가능

2. ChromaDB 테이블 중복 오류

에러

sqlite3.OperationalError: table embeddings_queue already exists

해결

데이터베이스 파일 찾기:

dir C:\Users\kub84\project\mcp-usecase\ /s /b | findstr chroma.sqlite3

데이터베이스 파일 삭제:

del C:\Users\kub84\project\mcp-usecase\case1\vector_db\chroma.sqlite3

3. 컬렉션 중복 오류

에러

chromadb.errors.UniqueConstraintError: Collection already exists

해결

ChromaDB 데이터 폴더 전체 삭제:

# 관련 프로세스 종료 후
rmdir /s /q C:\Users\kub84\project\mcp-usecase\case1\vector_db

배운 점

1. 가상환경 관리의 중요성
2. 데이터베이스 상태 관리 필요성
3. 프로세스와 파일 점유 관리
4. 정확한 로그 분석의 중요성