← Explore all mcp servers

VECTOR MEMORY / Qdrant

Qdrant MCP Server

Stores text plus metadata and retrieves semantic matches from a configured Qdrant collection; its outputs are context text, not a scored retrieval-evaluation dataset.

“An official Model Context Protocol server for keeping and retrieving memories in the Qdrant vector search engine.”

01 / THE REASONING

Why this made the selection.

  • The actual tool registration removes qdrant-store when QDRANT_READ_ONLY is enabled, allowing a narrower retrieval setup.
  • The connector exposes how information and metadata become payloads, and the settings define collection binding, result count and optional filter exposure.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • README.md, pyproject.toml and LICENSE
  • src/mcp_server_qdrant/server.py
  • src/mcp_server_qdrant/mcp_server.py
  • src/mcp_server_qdrant/settings.py
  • src/mcp_server_qdrant/qdrant.py
  • src/mcp_server_qdrant/embeddings/fastembed.py and factory.py
  • src/mcp_server_qdrant/common/wrap_filters.py

Our findings

  • Store accepts information and optional object metadata; find accepts query. When COLLECTION_NAME is set, collection_name is bound out of both exposed signatures; otherwise the caller supplies it. Optional filter arguments depend on filterable_fields or QDRANT_ALLOW_ARBITRARY_FILTER.
  • find returns a query header and entry-tagged strings with content and JSON metadata, or None. Its connector constructs Entry from payload document/metadata only, discarding score and point ID; the default result limit is 10.
  • store embeds the text, creates a missing collection with cosine vectors and optional indexes, and upserts a fresh random ID. A workflow needing reproducible retrieval metrics needs a separate measurement/identity path.
  • settings.py rejects local_path with either location or api_key. FastEmbed uses distinct passage_embed/query_embed calls and names the vector from the model's final path segment.
  • The manifest declares Python >=3.10, FastMCP ==2.7.0, FastEmbed >=0.6.0, qdrant-client >=1.12.0 and pydantic >=2.10.6,<2.12.0, built with hatchling. These are inspected constraints, not installed versions or advisory clearance.
  • This narrows the prior generic automatic-collection wording to the actual store path. Existing config and install receipts remain unchanged.

Not established by this review

  • No installation, model download, server startup, MCP handshake, Qdrant connection, read, write or filter call was performed.
  • No embedding compatibility, retrieval relevance, duplicate handling, listener authentication or package-advisory audit. Remaining filter/partial-function helpers and third-party implementations were not exhaustively audited.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Connect a server deliberately.

Upstream setup instructions ↗

DOCUMENTED COMMAND

uvx mcp-server-qdrant

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

  1. Set the Qdrant URL or local path and collection configuration.
  2. For retrieval-only access, set QDRANT_READ_ONLY=true and use appropriately scoped Qdrant credentials.

Before you start

  • uv/Python 3.10 or newer, a Qdrant endpoint or local data path, and storage for the embedding model.

Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

{
  "qdrant": {
    "command": "uvx",
    "args": [
      "mcp-server-qdrant"
    ],
    "env": {
      "QDRANT_URL": "https://xyz-example.eu-central.aws.cloud.qdrant.io:6333",
      "QDRANT_API_KEY": "your_api_key",
      "COLLECTION_NAME": "your-collection-name",
      "EMBEDDING_MODEL": "sentence-transformers/all-MiniLM-L6-v2"
    }
  }
}

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/qdrant/mcp-server-qdrant/blob/c56ae5adf62bb78d852bf7bbcbc5d7b75e2bbe41/README.md

    Supports: upstreamDescription, install, compatibility, transports, configExample, limitations

  2. https://github.com/qdrant/mcp-server-qdrant/blob/c56ae5adf62bb78d852bf7bbcbc5d7b75e2bbe41/src/mcp_server_qdrant/mcp_server.py

    Supports: summary, whySelected, bestFor, review, limitations, access

  3. https://github.com/qdrant/mcp-server-qdrant/blob/c56ae5adf62bb78d852bf7bbcbc5d7b75e2bbe41/src/mcp_server_qdrant/qdrant.py

    Supports: review, limitations, access

  4. https://github.com/qdrant/mcp-server-qdrant/blob/c56ae5adf62bb78d852bf7bbcbc5d7b75e2bbe41/src/mcp_server_qdrant/settings.py

    Supports: review, limitations

  5. Embedding adapter ↗Checked

    https://github.com/qdrant/mcp-server-qdrant/blob/c56ae5adf62bb78d852bf7bbcbc5d7b75e2bbe41/src/mcp_server_qdrant/embeddings/fastembed.py

    Supports: review, limitations

  6. https://github.com/qdrant/mcp-server-qdrant/blob/c56ae5adf62bb78d852bf7bbcbc5d7b75e2bbe41/pyproject.toml

    Supports: review, limitations

  7. Repository licence ↗Checked

    https://github.com/qdrant/mcp-server-qdrant/blob/c56ae5adf62bb78d852bf7bbcbc5d7b75e2bbe41/LICENSE

    Supports: license

Evidence & Ask