Skip to main content
Glama
Better Qdrant MCP Server

Better Qdrant MCP Server

by wrediam

Mejor servidor Qdrant MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para mejorar la funcionalidad de la base de datos vectorial de Qdrant. Este servidor proporciona herramientas para gestionar colecciones de Qdrant, añadir documentos y realizar búsquedas semánticas.

Características

  • Lista de colecciones : Ver todas las colecciones de Qdrant disponibles

  • Agregar documentos : procese y agregue documentos a una colección de Qdrant con varios servicios de integración

  • Buscar : Realice búsquedas semánticas en su base de datos de vectores

  • Eliminar colección : elimine colecciones de su base de datos de Qdrant

Related MCP server: doc-lib-mcp

Instalación

npm install -g better-qdrant-mcp-server

O úselo directamente con npx:

npx better-qdrant-mcp-server

Configuración

El servidor utiliza variables de entorno para la configuración. Puede configurarlas en un archivo .env en la raíz del proyecto:

# Qdrant Configuration
QDRANT_URL=http://localhost:6333
QDRANT_API_KEY=your_api_key_if_needed

# Embedding Service API Keys
OPENAI_API_KEY=your_openai_api_key
OPENROUTER_API_KEY=your_openrouter_api_key
OLLAMA_ENDPOINT=http://localhost:11434

Servicios de incrustación compatibles

  • OpenAI : Requiere una clave API

  • OpenRouter : requiere una clave API

  • Ollama : modelos de incrustación local (punto final predeterminado: http://localhost:11434 )

  • FastEmbed : modelos de incrustación local

Uso con Claude

Para utilizar este servidor MCP con Claude, agréguelo a su archivo de configuración de MCP:

{
  "mcpServers": {
    "better-qdrant": {
      "command": "npx",
      "args": ["better-qdrant-mcp-server"],
      "env": {
        "QDRANT_URL": "http://localhost:6333",
        "QDRANT_API_KEY": "your_api_key_if_needed",
        "DEFAULT_EMBEDDING_SERVICE": "ollama",
        "OPENAI_API_KEY": "your_openai_api_key",
        "OPENAI_ENDPOINT": "https://api.openai.com/v1",
        "OPENROUTER_API_KEY": "your_openrouter_api_key",
        "OPENROUTER_ENDPOINT": "https://api.openrouter.com/v1",
        "OLLAMA_ENDPOINT": "http://localhost:11434",
        "OLLAMA_MODEL": "nomic-embed-text"
      }
    }
  }
}

Comandos de ejemplo

Colecciones de listas

use_mcp_tool
server_name: better-qdrant
tool_name: list_collections
arguments: {}

Agregar documentos

use_mcp_tool
server_name: better-qdrant
tool_name: add_documents
arguments: {
  "filePath": "/path/to/your/document.pdf",
  "collection": "my-collection",
  "embeddingService": "openai",
  "chunkSize": 1000,
  "chunkOverlap": 200
}

Buscar

use_mcp_tool
server_name: better-qdrant
tool_name: search
arguments: {
  "query": "your search query",
  "collection": "my-collection",
  "embeddingService": "openai",
  "limit": 5
}

Eliminar colección

use_mcp_tool
server_name: better-qdrant
tool_name: delete_collection
arguments: {
  "collection": "my-collection"
}

Requisitos

  • Node.js >= 18.0.0

  • Un servidor Qdrant en ejecución (local o remoto)

  • Claves API para los servicios de incrustación que desea utilizar

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Available Tools

4 tools
add_documentsC

Add documents to a Qdrant collection with specified embedding service

Inputs: collection (required), embeddingService (required), filePath (required), chunkOverlap, +1 more.

delete_collectionC

Delete a Qdrant collection

Inputs: collection (required).

list_collectionsB

List all available Qdrant collections

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: add_documents handles document insertion, delete_collection removes collections, list_collections enumerates them, and search performs similarity queries. There is no overlap in functionality, making tool selection straightforward.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern (add_documents, delete_collection, list_collections, search). The naming is uniform and predictable, with no deviations in style or convention.

    Tool Count3/5

    With only 4 tools, the set feels thin for a vector database server, lacking operations like collection creation, document updates, or deletion. While the tools cover basic CRUD aspects, the scope is limited and may require workarounds for full functionality.

    Completeness2/5

    There are significant gaps in the tool surface for a Qdrant server: no create_collection tool, no update or delete document operations, and no management of embeddings or configurations. This incomplete coverage will likely cause agent failures in common workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that enables semantic search and retrieval of documentation using a vector database (Qdrant). This server allows you to add documentation from URLs or local files and then search through them using natural language queries.
      33 npm
      136
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server for Retrieval-Augmented Generation (RAG) operations. It provides tools for building and querying vector-based knowledge bases from document collections, enabling semantic search and document retrieval capabilities.
      15 PyPI
      3
      MIT