MCP Catalogs
Home

qdrant-mcp-server

by mhalder·32·Score 46

MCP server for semantic search using Qdrant vector database with multiple embedding providers.

searchai-llmdeveloper-tools
20
Forks
4
Open issues
this month
Last commit
2d ago
Indexed

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:

you:Semantic code search in large codebases with AST-aware chunking
you:Git history search to find past changes, fixes, and patterns
you:Building knowledge bases and RAG applications with local vector storage
you:Cross-repository federated search with Reciprocal Rank Fusion
you:Which embedding providers are supported?
you:Can I use Qdrant Cloud?

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 README
  • create_collection

    Create collection with specified distance metric (Cosine/Euclid/Dot)

  • add_documents

    Add documents with automatic embedding (supports string/number IDs, metadata)

  • semantic_search

    Natural language search with optional metadata filtering

  • hybrid_search

    Hybrid search combining semantic and keyword (BM25) search with RRF

  • index_codebase

    Index a codebase for semantic code search with AST-aware chunking

  • search_code

    Search indexed codebase using natural language queries

  • index_git_history

    Index git commit history for semantic search over past changes and fixes

  • search_git_history

    Search indexed git history using natural language queries

  • contextual_search

    Combined code + git history search with file-commit correlations

  • federated_search

    Search across multiple repositories with Reciprocal Rank Fusion (RRF) ranking

  • reindex_changes

    Incrementally re-index only changed files (detects added/modified/deleted)

  • delete_documents

    Delete specific documents by ID

Comparable tools

semantic-search-mcpvector-search-toolchroma-mcp-server

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 build

Claude 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

GitHub →

Last updated · Auto-generated from public README + GitHub signals.