O que é Qdrant MCP Server?
O mcp-server-qdrant é o servidor MCP oficial da Qdrant, o motor de busca vetorial de código aberto. O README o descreve como uma camada de memória semântica: o modelo salva texto e depois o encontra de novo pelo significado, e não por palavras exatas. O repositório tem cerca de 1.550 estrelas no GitHub e licença Apache 2.0.
Ele tem duas ferramentas. qdrant-store salva uma informação com metadados JSON opcionais, e qdrant-find faz uma busca semântica que devolve até 10 resultados por padrão. O texto recebe embeddings localmente com o FastEmbed, por padrão sentence-transformers/all-MiniLM-L6-v2, e o FastEmbed é o único provedor suportado. Ele aponta para um servidor Qdrant ou um cluster na nuvem (QDRANT_URL mais uma chave de API) ou para um banco local em disco, e cria a coleção se ela não existir. QDRANT_READ_ONLY=true remove a ferramenta de armazenamento, e desde a 0.8.0 a ferramenta de busca pode expor filtros de payload configurados em código.
Rode-o com uvx mcp-server-qdrant; stdio é o padrão, com SSE e Streamable HTTP escutando em 127.0.0.1:8000, a menos que você mude. A versão mais recente no PyPI é a 0.8.1, de dezembro de 2025; o último commit, que acrescentou suporte ao Kiro, foi em agosto de 2026.
Como instalar Qdrant MCP Server
uvx mcp-server-qdrantQdrant MCP Server vale a pena?
O design é estreito de propósito. Duas ferramentas, uma coleção padrão e embeddings locais tornam fácil entendê-lo, e reescrever as descrições das ferramentas por variáveis de ambiente o transforma em um repositório de trechos de código para Cursor, Windsurf ou Claude Code. Nada vai para uma API de embeddings: o FastEmbed roda o MiniLM na sua máquina, e o único tráfego de rede é para a instância Qdrant que você escolheu.
Os limites aparecem rápido. Ele não consegue listar, atualizar ou apagar pontos nem gerenciar coleções, e só modelos FastEmbed são suportados, então ele não vai buscar em uma coleção construída por outro pipeline com vetores da OpenAI ou da Cohere. A filtragem por payload existe desde a 0.8.0, mas é configurada criando uma subclasse do servidor em Python, e não pelas variáveis de ambiente documentadas, e uma issue aberta relata que a condição 'except' nunca funciona.
Sobre segurança, os transportes HTTP escutam em 127.0.0.1 por padrão, mas o exemplo de Docker do README define 0.0.0.0 e o endpoint MCP não tem autenticação própria, então qualquer coisa que alcance a porta pode ler e escrever memórias. As memórias guardadas também são um canal de injeção de prompt: qdrant-find devolve o texto salvo literalmente, e uma issue aberta observa que ele não escapa tags estruturais, então qualquer coisa que um agente tenha guardado de uma página não confiável volta como contexto. O modo somente leitura é o padrão certo para agentes que só recuperam.
A manutenção é lenta. O pyproject fixa o fastmcp exatamente na 2.7.0, e uma issue de agosto de 2026 lista 14 achados do OSV contra essa versão, incluindo um SSRF crítico no provedor OpenAPI do FastMCP, sem correção lançada. Em comparação com o arquivo de grafo de conhecimento local do servidor de memória de referência, este oferece busca semântica de verdade; em comparação com serviços de memória hospedados, controle ao custo de recursos e de ritmo de correções.
Onde ele se destaca
Um desenvolvedor que usa o Claude Code em vários repositórios
Manter um repositório pesquisável de trechos de código reutilizáveis e decisões
Rode com COLLECTION_NAME=code-snippets e descrições de ferramentas personalizadas; o agente guarda trechos com metadados e os encontra depois pelo significado. Gratuito com um banco local em disco; os vetores do MiniLM têm 384 dimensões, cerca de 1.5 KB cada.
Uma equipe de plataforma que já roda o Qdrant para RAG
Dar a agentes internos acesso somente leitura a uma coleção de conhecimento curada
Aponte o servidor para o cluster com QDRANT_READ_ONLY=true para que só qdrant-find seja exposto. Só funciona se a coleção tiver recebido embeddings do mesmo modelo FastEmbed; caso contrário, precisa ser reindexada.
Uma pequena startup de IA prototipando memória para agentes
Testar memória de longo prazo antes de pagar por um serviço gerenciado
Use o nó gratuito de 1 GB do Qdrant Cloud; a cerca de 1.5 KB por vetor MiniLM, 100.000 memórias dão cerca de 150 MB de vetores antes do overhead do índice. A passagem para o Standard é cobrada por uso quando o protótipo crescer.
Antes de decidir
- Configuração
- uvx mcp-server-qdrant com QDRANT_URL ou QDRANT_LOCAL_PATH e COLLECTION_NAME definidos; o README documenta Claude Desktop, Cursor, Windsurf, VS Code e Claude Code. A primeira execução baixa o modelo FastEmbed, e depois uma primeira chamada leva um ou dois minutos.
- Integrações
- Duas ferramentas: qdrant-store (escrita) e qdrant-find (leitura, até QDRANT_SEARCH_LIMIT resultados, padrão 10). O modo somente leitura remove a ferramenta de armazenamento; filtros em campos de payload exigem configuração no código.
- Dados e privacidade
- Lê e escreve na coleção configurada com a chave de API do Qdrant que você fornecer; os embeddings são calculados localmente. O texto guardado volta literalmente ao modelo, então memórias salvas de fontes não confiáveis podem trazer instruções injetadas. O endpoint HTTP não tem autenticação própria.
- Custo em escala
- O servidor é gratuito. O Qdrant auto-hospedado custa só a máquina; o nível gratuito do Qdrant Cloud é um nó de 0.5 vCPU e 1 GB de RAM, o Standard é cobrado por uso e o Premium, com SSO e links de VPC privada, tem gasto mínimo.
- Limites
- Sem ferramentas de atualização, exclusão ou coleções, apenas FastEmbed, fastmcp fixado na 2.7.0 com alertas em aberto, e sem limiar de pontuação nem deduplicação nos resultados, segundo uma issue aberta.
O que é bom
- Servidor oficial da Qdrant
- Embeddings locais, sem precisar de API externa
- Modo somente leitura e descrições de ferramentas personalizáveis
- Funciona com um arquivo local, um servidor auto-hospedado ou o Qdrant Cloud
O que não é
- Só armazenar e buscar; sem atualização, exclusão ou gerenciamento de coleções
- Apenas modelos FastEmbed
- Fixa o fastmcp 2.7.0 com alertas conhecidos; sem release desde dezembro de 2025
- Sem autenticação no próprio endpoint HTTP
Ideal para
Equipes que já rodam o Qdrant e querem uma memória semântica ou um repositório de trechos simples e auto-hospedado para seus agentes.
Alternativas ao Qdrant MCP Server
Qdrant MCP Server: perguntas frequentes
- Qdrant MCP Server vale a pena?
- Uma memória organizada e local para agentes que já ficam ao lado do Qdrant, pequena demais de propósito para ser uma interface geral para o banco de dados. Damos nota 3.7 de 5.
- Quanto custa Qdrant MCP Server?
- Gratuito e de código aberto (Apache 2.0). O Qdrant é gratuito para auto-hospedar; o Qdrant Cloud tem um nível gratuito de um nó (0.5 vCPU, 1 GB de RAM, 4 GB de disco), um Standard cobrado por uso e um nível Premium com gasto mínimo.
- Quais são as desvantagens de Qdrant MCP Server?
- Só armazenar e buscar; sem atualização, exclusão ou gerenciamento de coleções; apenas modelos FastEmbed; fixa o fastmcp 2.7.0 com alertas conhecidos; sem release desde dezembro de 2025; sem autenticação no próprio endpoint HTTP.
- Para quem Qdrant MCP Server é indicado?
- Equipes que já rodam o Qdrant e querem uma memória semântica ou um repositório de trechos simples e auto-hospedado para seus agentes.
- Quanto custa Qdrant MCP Server para uma equipe ou em produção?
- O servidor é gratuito. O Qdrant auto-hospedado custa só a máquina; o nível gratuito do Qdrant Cloud é um nó de 0.5 vCPU e 1 GB de RAM, o Standard é cobrado por uso e o Premium, com SSO e links de VPC privada, tem gasto mínimo.
- Qdrant MCP Server é seguro para dados da empresa?
- Lê e escreve na coleção configurada com a chave de API do Qdrant que você fornecer; os embeddings são calculados localmente. O texto guardado volta literalmente ao modelo, então memórias salvas de fontes não confiáveis podem trazer instruções injetadas. O endpoint HTTP não tem autenticação própria.
- Quais são as melhores alternativas ao Qdrant MCP Server?
- As alternativas mais próximas que analisamos são Memory (reference server), Redis MCP Server e MongoDB MCP Server.
Respostas verificadas em 23 de out. de 2026.