Qdrant MCP Server의 개요
mcp-server-qdrant는 오픈소스 벡터 검색 엔진 Qdrant가 내놓은 공식 MCP 서버입니다. README는 이 서버를 의미 기반 메모리 계층으로 설명합니다. 모델이 텍스트를 저장해 두었다가, 나중에 정확한 단어가 아니라 의미로 다시 찾는 방식입니다. 저장소의 GitHub 스타는 약 1,550개이고 라이선스는 Apache 2.0입니다.
도구는 두 개입니다. qdrant-store는 선택적 JSON 메타데이터와 함께 정보를 저장하고, qdrant-find는 의미 검색을 실행해 기본적으로 최대 10개의 결과를 돌려줍니다. 텍스트는 FastEmbed로 로컬에서 임베딩되며 기본 모델은 sentence-transformers/all-MiniLM-L6-v2입니다. 지원하는 제공자는 FastEmbed뿐입니다. Qdrant 서버나 클라우드 클러스터(QDRANT_URL과 API 키), 또는 디스크에 저장되는 로컬 데이터베이스에 연결하며, 컬렉션이 없으면 새로 만듭니다. QDRANT_READ_ONLY=true를 설정하면 store 도구가 빠지고, 0.8.0부터는 find 도구가 코드에서 설정한 payload 필터를 노출할 수 있습니다.
uvx mcp-server-qdrant로 실행합니다. 기본은 stdio이며, SSE와 Streamable HTTP는 바꾸지 않으면 127.0.0.1:8000에 바인딩됩니다. 최신 PyPI 릴리스는 2025년 12월의 0.8.1이고, 마지막 커밋은 2026년 8월에 Kiro 지원을 추가한 것입니다.
Qdrant MCP Server 설치 방법
uvx mcp-server-qdrantQdrant MCP Server, 쓸 만한 가치가 있습니까?
설계는 일부러 좁습니다. 도구 두 개, 기본 컬렉션 하나, 로컬 임베딩이라 동작을 이해하기 쉽습니다. 환경 변수로 도구 설명을 바꿔 쓰면 Cursor, Windsurf, Claude Code를 위한 코드 조각 저장소가 됩니다. 임베딩 API로 가는 것은 없습니다. FastEmbed가 사용자의 컴퓨터에서 MiniLM을 실행하고, 네트워크 트래픽은 사용자가 고른 Qdrant 인스턴스로 가는 것뿐입니다.
한계는 금방 드러납니다. 포인트를 나열하거나 수정하거나 삭제할 수 없고, 컬렉션을 관리할 수도 없습니다. FastEmbed 모델만 지원하므로, 다른 파이프라인이 OpenAI나 Cohere 벡터로 만든 컬렉션은 검색하지 못합니다. payload 필터링은 0.8.0부터 있지만, 문서화된 환경 변수가 아니라 Python에서 서버를 서브클래싱해서 설정해야 하며, 열린 issue에 따르면 'except' 조건은 전혀 작동하지 않습니다.
보안 면에서 HTTP 전송은 기본적으로 127.0.0.1에 바인딩되지만, README의 Docker 예제는 0.0.0.0을 설정하고, MCP 엔드포인트에는 자체 인증이 없습니다. 따라서 포트에 닿을 수 있는 것은 무엇이든 메모리를 읽고 쓸 수 있습니다. 저장된 메모리는 프롬프트 인젝션의 통로이기도 합니다. qdrant-find는 저장된 텍스트를 그대로 돌려주며, 열린 issue에 따르면 구조 태그를 이스케이프하지 않습니다. 그래서 에이전트가 한때 신뢰할 수 없는 페이지에서 저장한 것은 무엇이든 컨텍스트로 돌아옵니다. 검색만 하는 에이전트라면 읽기 전용 모드가 맞는 기본값입니다.
유지보수는 느립니다. pyproject는 fastmcp를 정확히 2.7.0으로 고정하고 있으며, 2026년 8월의 issue는 그 버전에 대한 OSV 지적 14건을 나열합니다. 여기에는 FastMCP의 OpenAPI provider에 있는 심각한 SSRF도 포함되며, 수정 릴리스는 나오지 않았습니다. 로컬 지식 그래프 파일을 쓰는 참조용 memory 서버와 비교하면 진짜 의미 검색을 제공합니다. 호스팅형 메모리 서비스와 비교하면, 기능과 패치 주기를 내주는 대신 통제권을 얻습니다.
제 역할을 하는 곳
여러 저장소에서 Claude Code를 쓰는 개발자
다시 쓸 수 있는 코드 조각과 결정 사항을 검색 가능한 형태로 보관하기
COLLECTION_NAME=code-snippets와 맞춤 도구 설명으로 실행합니다. 에이전트가 메타데이터와 함께 코드 조각을 저장하고, 나중에 의미로 찾아냅니다. 디스크에 저장되는 로컬 데이터베이스라면 무료입니다. MiniLM 벡터는 384차원으로, 하나에 약 1.5 KB입니다.
이미 RAG용으로 Qdrant를 운영하는 플랫폼 팀
사내 에이전트에게 선별된 지식 컬렉션에 대한 읽기 전용 접근 주기
QDRANT_READ_ONLY=true로 서버를 클러스터에 연결해 qdrant-find만 노출합니다. 컬렉션이 같은 FastEmbed 모델로 임베딩된 경우에만 작동하며, 그렇지 않으면 다시 색인해야 합니다.
에이전트 메모리의 시제품을 만드는 작은 AI 스타트업
관리형 서비스에 돈을 내기 전에 장기 메모리 시험하기
Qdrant Cloud의 무료 1 GB 노드를 씁니다. MiniLM 벡터 하나가 약 1.5 KB이므로, 메모리 100,000개는 색인 오버헤드 전에 벡터만 약 150 MB입니다. 시제품이 커져 Standard로 옮기면 사용량 기반으로 과금됩니다.
도입 전 확인할 점
- 설정
- QDRANT_URL 또는 QDRANT_LOCAL_PATH와 COLLECTION_NAME을 설정하고 uvx mcp-server-qdrant를 실행합니다. README는 Claude Desktop, Cursor, Windsurf, VS Code, Claude Code를 다룹니다. 처음 실행하면 FastEmbed 모델을 내려받고, 그 뒤 첫 호출까지 1~2분이 걸립니다.
- 연동
- 도구는 두 개입니다. qdrant-store(쓰기)와 qdrant-find(읽기, 최대 QDRANT_SEARCH_LIMIT개 결과, 기본 10개)입니다. 읽기 전용 모드에서는 store 도구가 빠집니다. payload 필드 필터에는 코드 수준의 설정이 필요합니다.
- 데이터와 개인정보
- 사용자가 제공한 Qdrant API 키로 설정된 컬렉션을 읽고 씁니다. 임베딩은 로컬에서 계산됩니다. 저장된 텍스트는 그대로 모델에 돌아가므로, 신뢰할 수 없는 출처에서 저장한 메모리에는 주입된 지시가 담길 수 있습니다. HTTP 엔드포인트에는 자체 인증이 없습니다.
- 대규모 사용 시 비용
- 서버는 무료입니다. 직접 호스팅하는 Qdrant는 서버 비용만 듭니다. Qdrant Cloud의 무료 등급은 0.5 vCPU, 1 GB RAM 노드 하나이고, Standard는 사용량 기반이며, SSO와 private VPC 연결이 있는 Premium에는 최소 지출액이 있습니다.
- 제한
- 수정, 삭제, 컬렉션 도구가 없고, FastEmbed만 지원하며, fastmcp가 열린 권고가 있는 2.7.0에 고정되어 있습니다. 열린 issue에 따르면 결과에 점수 기준선이나 중복 제거도 없습니다.
좋은 점
- Qdrant의 공식 서버
- 로컬 임베딩을 쓰므로 외부 API가 필요 없습니다
- 읽기 전용 모드와 바꿔 쓸 수 있는 도구 설명
- 로컬 파일, 직접 호스팅한 서버, Qdrant Cloud와 모두 작동합니다
아쉬운 점
- 저장과 검색뿐이며, 수정, 삭제, 컬렉션 관리가 없습니다
- FastEmbed 모델만 지원합니다
- 알려진 권고가 있는 fastmcp 2.7.0에 고정되어 있고, 2025년 12월 이후 릴리스가 없습니다
- HTTP 엔드포인트 자체에 인증 이 없습니다
추천 대상
이미 Qdrant를 운영하면서, 에이전트를 위한 단순한 자체 호스팅 의미 기반 메모리나 코드 조각 저장소를 원하는 팀.
Qdrant MCP Server 대안
Qdrant MCP Server: 자주 묻는 질문
- Qdrant MCP Server, 쓸 만한 가치가 있습니까?
- 이미 Qdrant를 곁에 두고 있는 에이전트를 위한, 깔끔한 로컬 우선 메모리입니다. 데이터베이스 전반을 다루는 인터페이스가 되기에는 의도적으로 작게 만들어졌습니다. 평점은 5점 만점에 3.7점입니다.
- Qdrant MCP Server의 가격은 얼마입니까?
- 무료 오픈소스(Apache 2.0)입니다. Qdrant는 직접 호스팅하면 무료입니다. Qdrant Cloud에는 무료 단일 노드 등급(0.5 vCPU, 1 GB RAM, 4 GB 디스크), 사용량 기반의 Standard, 최소 지출액이 있는 Premium 등급이 있습니다.
- Qdrant MCP Server의 단점은 무엇입니까?
- 저장과 검색뿐이며, 수정, 삭제, 컬렉션 관리가 없습니다; FastEmbed 모델만 지원합니다; 알려진 권고가 있는 fastmcp 2.7.0에 고정되어 있고, 2025년 12월 이후 릴리스가 없습니다; HTTP 엔드포인트 자체에 인증이 없습니다.
- Qdrant MCP Server에 적합한 사람은 누구입니까?
- 이미 Qdrant를 운영하면서, 에이전트를 위한 단순한 자체 호스팅 의미 기반 메모리나 코드 조각 저장소를 원하는 팀.
- 팀이나 프로덕션 환경에서 Qdrant MCP Server의 비용은 얼마입니까?
- 서버는 무료입니다. 직접 호스팅하는 Qdrant는 서버 비용만 듭니다. Qdrant Cloud의 무료 등급은 0.5 vCPU, 1 GB RAM 노드 하나이고, Standard는 사용량 기반이며, SSO와 private VPC 연결이 있는 Premium에는 최소 지출액이 있습니다.
- Qdrant MCP Server에 회사 데이터를 맡겨도 안전합니까?
- 사용자가 제공한 Qdrant API 키로 설정된 컬렉션을 읽고 씁니다. 임베딩은 로컬에서 계산됩니다. 저장된 텍스트는 그대로 모델에 돌아가므로, 신뢰할 수 없는 출처에서 저장한 메모리에는 주입된 지시가 담길 수 있습니다. HTTP 엔드포인트에는 자체 인증이 없습니다.
- Qdrant MCP Server의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Memory (reference server), Redis MCP Server 및 MongoDB MCP Server입니다.
답변 확인일: 2026년 10월 23일.