# Qdrant MCP

> Qdrant MCP is an open-source MCP server for knowledge and memory. Full Qdrant API as 58 MCP tools, with plain-text semantic, BM25 and hybrid search. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://mcp-qdrant.vazquezlabs.com
- **Repository:** https://github.com/avaazquezz/qdrant-mcp
- **MCP Registry name:** io.github.avaazquezz/mcp-qdrant
- **Categories:** knowledge and memory, databases, AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

Where the official Qdrant server exposes two tools, store and find, this one wraps the API one operation per tool: collection lifecycle, point CRUD, payload and vector editing, snapshots, and server observability. The author's site lists 33 of the 58 tools as read-only and describes the project as a portfolio piece, run by you rather than hosted.

Search covers dense, sparse and multivectors, RRF and DBSF hybrid fusion, nested prefetch with reranking, MMR diversity, grouped queries, recommend and discover. With the optional embeddings extra you can pass plain text: semantic search is embedded locally with fastembed using the model a collection declares, and BM25 keyword search needs no embeddings on Qdrant 1.20.

Two advisor tools stand out. qdrant_collection_doctor checks a collection's status, index, memory, aliases and text setup and answers each finding with the tool call that fixes it, and qdrant_search_quality_eval measures recall@k of approximate search against exact search. Safety settings include toolset selection, a read-only mode that removes every non-read-only tool, a cap on points per call, and an allowlist of origins for snapshot restore. The default toolset's schemas are about 48 KB.

## Features

- **One tool per operation:** Wraps the Qdrant API one-to-one rather than just store and find.
- **Plain-text search:** Semantic, BM25 and hybrid queries from text.
- **Search advisor:** Diagnose a collection and measure recall against exact search.
- **Toolset selection:** Enable core, search, payload, admin, snapshots or observability groups.
- **Read-only mode:** Remove every tool not marked read-only.
- **Request cap:** Calls asking for more than the configured point limit are refused.
- **Snapshots:** Per-collection and full-storage backup and restore.

## Good for

- Create and tune a Qdrant collection from chat
- Run hybrid search over an existing collection
- Diagnose why a collection's search seems slow
- Back up and restore snapshots
- Inspect a database safely in read-only mode

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-qdrant --env QDRANT_API_KEY='<QDRANT_API_KEY>' -- uvx mcp-qdrant
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-qdrant": {
      "command": "uvx",
      "args": [
        "mcp-qdrant"
      ],
      "env": {
        "QDRANT_API_KEY": "<QDRANT_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-qdrant": {
      "command": "uvx",
      "args": [
        "mcp-qdrant"
      ],
      "env": {
        "QDRANT_API_KEY": "<QDRANT_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-qdrant": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-qdrant"
      ],
      "env": {
        "QDRANT_API_KEY": "<QDRANT_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-qdrant": {
      "command": "uvx",
      "args": [
        "mcp-qdrant"
      ],
      "env": {
        "QDRANT_API_KEY": "<QDRANT_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-qdrant": {
      "command": "uvx",
      "args": [
        "mcp-qdrant"
      ],
      "env": {
        "QDRANT_API_KEY": "<QDRANT_API_KEY>"
      }
    }
  }
}
```

## Tools

- `qdrant_collection_doctor`: Checks a collection's status, index, memory, aliases and text setup and suggests the fixing tool call.
- `qdrant_search_quality_eval`: Measures recall@k of approximate versus exact search, plus latency.
- `qdrant_snapshot_recover`: Restores a snapshot from file, the Qdrant URL's origin or allowed origins.

## FAQ

### How is it installed?

From PyPI as mcp-qdrant, with Docker, or as a Claude Desktop bundle.

### Does it need a hosted service?

No. The site says there is no hosted instance; you run it against your own Qdrant via QDRANT_URL or QDRANT_LOCAL_PATH.

### Is it a RAG pipeline?

No. The README says it never parses documents or decides how to chunk text.

### How do I limit what an agent can do?

Set QDRANT_MCP_READ_ONLY, pick toolsets with QDRANT_MCP_TOOLSETS, or lower QDRANT_MCP_MAX_LIMIT.

### How is it tested?

The site reports 766 tests, with CI against a real Qdrant server.

### Is Qdrant MCP free?

Yes. Qdrant MCP is open source, so you can use and self-host it for free.

### How do I add Qdrant MCP to Claude Code?

Run this command in your terminal: claude mcp add mcp-qdrant --env QDRANT_API_KEY='<QDRANT_API_KEY>' -- uvx mcp-qdrant

### What are the best alternatives to Qdrant MCP?

The closest alternatives to Qdrant MCP are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and Midplane.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/qdrant-mcp
