qdrant-mcp-server
by mhalder·★ 32·Score 46
MCP server for semantic search using Qdrant vector database with multiple embedding providers.
Overview
The Qdrant MCP Server provides comprehensive semantic search capabilities with local-first architecture. It supports multiple embedding providers including Ollama, OpenAI, Cohere, and Voyage AI. The server features advanced code vectorization with AST-aware chunking, Git history indexing, and hybrid search combining semantic and keyword search. It can be deployed locally via stdio transport or remotely as an HTTP server with authentication support.
Try asking AI
After installing, here are 6 things you can ask your AI assistant:
When to choose this
Choose this when you need semantic search capabilities with local privacy-first vector storage or when working with existing Qdrant deployments.
When NOT to choose this
Avoid if you need support for other vector databases like Pinecone, Chroma, or Weaviate, as this is tightly coupled to Qdrant.
Tools this server exposes
12 tools extracted from the READMEcreate_collectionCreate collection with specified distance metric (Cosine/Euclid/Dot)
add_documentsAdd documents with automatic embedding (supports string/number IDs, metadata)
semantic_searchNatural language search with optional metadata filtering
hybrid_searchHybrid search combining semantic and keyword (BM25) search with RRF
index_codebaseIndex a codebase for semantic code search with AST-aware chunking
search_codeSearch indexed codebase using natural language queries
index_git_historyIndex git commit history for semantic search over past changes and fixes
search_git_historySearch indexed git history using natural language queries
contextual_searchCombined code + git history search with file-commit correlations
federated_searchSearch across multiple repositories with Reciprocal Rank Fusion (RRF) ranking
reindex_changesIncrementally re-index only changed files (detects added/modified/deleted)
delete_documentsDelete specific documents by ID
Comparable tools
Installation
Installation
Prerequisites
- Node.js 22.x or 24.x
- Podman or Docker with Compose support
Steps
# Clone and install
git clone https://github.com/mhalder/qdrant-mcp-server.git
cd qdrant-mcp-server
npm install
# Start services
podman compose up -d # Using Podman
docker compose up -d # Using Docker
# Pull the embedding model
podman exec ollama ollama pull nomic-embed-text
# Build
npm run buildClaude Desktop Configuration
Add to ~/.claude.json:
{
"mcpServers": {
"qdrant": {
"type": "stdio",
"command": "node",
"args": ["/path/to/qdrant-mcp-server/build/index.js"]
}
}
}FAQ
- Which embedding providers are supported?
- The server supports Ollama (default), OpenAI, Cohere, and Voyage AI as embedding providers.
- Can I use Qdrant Cloud?
- Yes, you can connect to Qdrant Cloud or secured instances using API key authentication.
Compare qdrant-mcp-server with
Last updated · Auto-generated from public README + GitHub signals.