MCP Server for Qdrant

0.8.1 verified Fri May 01 auth: no python

MCP (Model Context Protocol) server that enables retrieval of context from a Qdrant vector database. Current version is 0.8.1, released under an ongoing development cadence. Requires Python >=3.10.

pip install mcp-server-qdrant

Common errors

error ModuleNotFoundError: No module named 'mcp_server_qdrant' ↓

cause Package not installed or wrong Python environment

fix

Run: pip install mcp-server-qdrant in the correct virtual environment

error qdrant_client.http.exceptions.ResponseHandlingException: 401: Unauthorized ↓

cause Missing or incorrect Qdrant API key

fix

Ensure QDRANT_API_KEY environment variable is set to your Qdrant cloud API key

error KeyError: 'qdrant.collection_name' ↓

cause Using old configuration key 'collection_name' without 'qdrant.' prefix

fix

Update configuration to use 'qdrant.collection_name' as the key

Warnings

breaking Version 0.7.0 changed the way collections are configured. Previously used 'collection_name' parameter; now requires 'qdrant.collection_name' in configuration. ↓

fix Update configuration keys to include 'qdrant.' prefix.

deprecated The legacy 'qdrant_url' and 'qdrant_api_key' environment variables are deprecated in favor of 'QDRANT_URL' and 'QDRANT_API_KEY'. ↓

fix Rename environment variables to uppercase versions.

gotcha The server requires an active Qdrant instance; it does not start embedded. Ensure Qdrant is running before using the MCP server. ↓

fix Start Qdrant via Docker: docker run -p 6333:6333 qdrant/qdrant

Imports

mcp_server_qdrant
wrong
```
from mcp_server_qdrant import server
```
correct
```
import mcp_server_qdrant
```
Direct import of submodules may break due to internal restructuring

Quickstart

Basic async usage of the Qdrant MCP server. Requires QDRANT_URL and QDRANT_API_KEY environment variables set.

import asyncio
import os
from mcp_server_qdrant import mcp

async def main():
    async with mcp.run_stdio_async() as (read, write):
        # Use the server
        pass

if __name__ == "__main__":
    asyncio.run(main())