What it does & operational scope
Qdrant Semantic Memory MCP Server connects AI agents to Qdrant vector databases over stdio pipes. It exposes primitives to create vector collections, store payload points with dense embeddings, and execute nearest-neighbor similarity searches using cosine distance or dot products across local Docker or Qdrant Cloud clusters.
Qdrant Semantic Memory MCP Server is an open-source Model Context Protocol server developed by Qdrant under Apache-2.0 that provides vector similarity search and semantic memory storage over stdio.
Your AI coding agent requires live access to Qdrant Semantic Memory tools and resources over local IPC or streamable transport.
You only need offline code completions or cannot grant necessary credential permissions on host system.
Client configuration & wire setup
Prerequisites: Node.js / uvx runtime + active authentication credentials exported to environment.
claude_desktop_config.json{ "mcpServers": { "qdrant": { "command": "uvx", "args": ["mcp-server-qdrant"], "env": { "QDRANT_URL": "http://localhost:6333", "COLLECTION_NAME": "agent_memory" } } }}Exposed tool endpoints & primitives
Discovered MCP Tools
4 Tools Readysearch_vectors🟢 Read-Only (Safe)Query Qdrant collection with dense vectors and metadata payload filters
upsert_points🟡 State MutationWrite vector points with unique IDs and custom JSON payload attributes
create_collection🟡 State MutationInitialize new Qdrant vector index with cosine or dot distance metric
get_collection_info🟢 Read-Only (Safe)Inspect point counts, segment configurations, and HNSW index parameters
Scopes, secret storage, and sandbox boundaries
Run Qdrant Semantic Memory MCP Server with scoped environment tokens. Never run under root and restrict network ingress.Real conversational prompts & expected tool calls
💬 "Find latest technical updates for Qdrant Semantic Memory MCP Server from the last 7 days"search_vectors({ query: "Qdrant Semantic Memory MCP Server updates", limit: 5 })Returned 5 verified entries with timestamps, authors, and payload hashes. Zero data loss.
💬 "Inspect status and health boundaries for Qdrant Semantic Memory MCP Server"search_vectors_status({ verbose: true })Status: 200 OK. Transport: STDIO IPC. Active connections: 1. Blast radius: Safe.
Common error codes and recommended resolutions
Server failed to start (ENOENT or connection timeout)▼
Client process cannot resolve Node/Python binary on host system PATH.
Provide full absolute path to the binary in your client config (e.g. "/opt/homebrew/bin/node" or "C:\\Program Files\\nodejs\\node.exe").
Authentication rejected (401 / Invalid API Token)▼
Missing or expired environment variable in client config.
Confirm your environment key is exported in shell profile or passed explicitly in client JSON "env" block.
Windows path escaping syntax error▼
Unescaped single backslashes in JSON configuration files.
Use forward slashes or double backslashes in path strings (e.g., "C:/Users/name/.env" or "C:\\Users\\name").
Technical trade-offs and operational friction
+ Backed by a high-performance Rust vector engine with fast HNSW indexing.
+ Combines vector similarity search with rich JSON payload attribute filters.
+ Scales smoothly from single-developer local setups to cloud-hosted clusters.
− Requires an accessible Qdrant instance URL and collection name, adding external network configuration overhead to local setups.
− Generating vector embeddings locally requires heavy embedding models or outbound calls to commercial embedding APIs.
Side-by-side rival comparisons
Compare Qdrant Semantic Memory MCP Server vs Chroma Vector Memory MCP Server across transport protocols and exposed tools.
Enter ShowdownJSON-RPC 2.0 wire trace & receipts
Inspect Raw JSON-RPC 2.0 Wire PacketIPC TELEMETRY
1{2 "jsonrpc": "2.0",3 "id": 1,4 "method": "tools/call",5 "params": {6 "name": "inspect",7 "arguments": {}8 }9}
