mcp-server-qdrant-retrieve
MCP server for semantic search with Qdrant vector database
Documentation
Qdrant Retrieve MCP Server
MCP server for semantic search with Qdrant vector database.
Features
- Semantic search across multiple collections
- Multi-query support
- Configurable result count
- Collection source tracking
Note: The server connects to a Qdrant instance specified by URL.
Note 2: The first retrieve might be slower, as the MCP server downloads the required embedding model.
API
Tools
- qdrant_retrieve
- Retrieves semantically similar documents from multiple Qdrant vector store collections based on multiple queries
- Inputs:
- `collectionNames` (string[]): Names of the Qdrant collections to search across
- `topK` (number): Number of top similar documents to retrieve (default: 3)
- `query` (string[]): Array of query texts to search for
- Returns:
- `results`: Array of retrieved documents with:
- `query`: The query that produced this result
- `collectionName`: Collection name that this result came from
- `text`: Document text content
- `score`: Similarity score between 0 and 1
- `results`: Array of retrieved documents with:
Usage with Claude Desktop
Add this to your `claude_desktop_config.json`:
{
"mcpServers": {
"qdrant": {
"command": "npx",
"args": ["-y", "@gergelyszerovay/mcp-server-qdrant-retrive"],
"env": {
"QDRANT_API_KEY": "your_api_key_here"
}
}
}
}Command Line Options
MCP server for semantic search with Qdrant vector database.
Options
--enableHttpTransport Enable HTTP transport [default: false]
--enableStdioTransport Enable stdio transport [default: true]
--enableRestServer Enable REST API server [default: false]
--mcpHttpPort= Port for MCP HTTP server [default: 3001]
--restHttpPort= Port for REST HTTP server [default: 3002]
--qdrantUrl= URL for Qdrant vector database [default: http://localhost:6333]
--embeddingModelType= Type of embedding model to use [default: Xenova/all-MiniLM-L6-v2]
--help Show this help message
Environment Variables
QDRANT_API_KEY API key for authenticated Qdrant instances (optional)
Examples
$ mcp-qdrant --enableHttpTransport
$ mcp-qdrant --mcpHttpPort=3005 --restHttpPort=3006
$ mcp-qdrant --qdrantUrl=http://qdrant.example.com:6333
$ mcp-qdrant --embeddingModelType=Xenova/all-MiniLM-L6-v2Frequently asked questions
What is mcp-server-qdrant-retrieve?
mcp-server-qdrant-retrieve is MCP server for semantic search with Qdrant vector database
How do I install mcp-server-qdrant-retrieve?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is mcp-server-qdrant-retrieve open source?
Yes — it is hosted on GitHub at https://github.com/gergelyszerovay/mcp-server-qdrant-retrieve.
Related MCP tools
Model Context Protocol Servers
The Open-Source Multimodal AI Agent Stack: Connecting Cutting-Edge AI Models and Agent Infra
A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you
MCP server to provide Figma layout information to AI coding agents like Cursor
The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Instant is the best backend for AI-coded apps. You get auth, permissions, storage, presence, and streams — everything you need to ship apps your users will love.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP