Registry / vector-search / mcp-server-qdrant

mcp-server-qdrant

JSON →
library0.8.1pypypi✓ verified 84d ago

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
INSTALL
IMPORT
SIG · MCP-SERVER-QDRANT
M
mcp-server-qdrant
vector-searchpythonv0.8.1
Install
17.2s avg
Import
Disk
276MB
Pass rate
5/ 10
Env Coverage5 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v0.8.1 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
glibc
py 3.10
✕ build_error
✓ 23s
py 3.11
✕ build_error
✓ 17s
py 3.12
✕ build_error
✓ 14s
py 3.13
✓ —
✓ 14.7s
py 3.9
✕ build_error
✕ build_error
276MB installed
● package 276MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

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

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())
mcp-server-qdrant --version
Debug
Known issues
breakingVersion 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.
affects: >=0.7.0
deprecatedThe 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.
affects: >=0.8.0
gotchaThe 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
affects: all
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'mcp_server_qdrant'
Package not installed or wrong Python environment
fix
Run: pip install mcp-server-qdrant in the correct virtual environment
qdrant_client.http.exceptions.ResponseHandlingException: 401: Unauthorized
Missing or incorrect Qdrant API key
fix
Ensure QDRANT_API_KEY environment variable is set to your Qdrant cloud API key
KeyError: 'qdrant.collection_name'
Using old configuration key 'collection_name' without 'qdrant.' prefix
fix
Update configuration to use 'qdrant.collection_name' as the key
Upgrade
Version history
0.8.1latest on PyPI · released Dec 10, 2025
Audit
Dependencies
qdrant-clientrequiredRequired for connecting to Qdrant
mcprequiredCore MCP protocol library
Agent activity
49 hits · last 30 days
node
44
OpenAI (training)
1
Resources
mcp-server-qdrant — pip install mcp-server-qdrant · libregistry