Qdrant Search MCP
Can be used as an MCP client with Hermes Agent to enable semantic code search capabilities.
Provides integration with local Ollama models for embedding generation, enabling semantic code search with locally hosted models.
Provides integration with OpenAI's embedding models for generating embeddings used in semantic code search.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Qdrant Search MCPfind code for user authentication"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Qdrant Search MCP
An MCP (Model Context Protocol) server for semantic code search via Qdrant vector database. Designed to work with codebases indexed by Kilo Code or similar tools.
Features
Semantic code search - find code by meaning, not just exact strings
Multiple embedding providers - OpenRouter, OpenAI, or local (Ollama)
Kilo Code compatible - works with payload formats from Kilo Code's indexer
Collection listing - browse available Qdrant collections with stats
Related MCP server: semantic-code-mcp
Quick Start
Prerequisites
Python 3.10+
A Qdrant instance (cloud or local)
An embedding API (OpenRouter, OpenAI, or local Ollama)
Installation
# Clone the repo
git clone https://github.com/sandeep-wt/qdrant-search-mcp.git
cd qdrant-search-mcp
# Create a virtual environment
python3 -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
# Install dependencies
pip install -r requirements.txtConfiguration
Set these environment variables:
# Required
export QDRANT_URL="https://your-qdrant-instance.example.com"
export QDRANT_API_KEY="your-qdrant-api-key"
export COLLECTION_NAME="your-collection-name"
# Embedding provider (default: openrouter)
export EMBEDDING_PROVIDER="openrouter" # or "openai" or "local"
# For OpenRouter
export OPENROUTER_API_KEY="your-openrouter-key"
export EMBEDDING_MODEL="qwen/qwen3-embedding-8b"
# For OpenAI
# export OPENAI_API_KEY="your-openai-key"
# export EMBEDDING_MODEL="text-embedding-3-small"
# For local (Ollama)
# export EMBEDDING_URL="http://localhost:11434/api/embeddings"
# export EMBEDDING_MODEL="nomic-embed-text"Running
python -m qdrant_search_mcpMCP Client Configuration
Claude Desktop / Cursor / Kilo Code
Add to your MCP settings:
{
"mcpServers": {
"qdrant-search": {
"command": "python",
"args": ["-m", "qdrant_search_mcp"],
"cwd": "/path/to/qdrant-search-mcp",
"env": {
"QDRANT_URL": "https://your-qdrant-url",
"QDRANT_API_KEY": "your-key",
"COLLECTION_NAME": "your-collection",
"EMBEDDING_PROVIDER": "openrouter",
"OPENROUTER_API_KEY": "your-openrouter-key",
"EMBEDDING_MODEL": "qwen/qwen3-embedding-8b"
}
}
}
}Hermes Agent
hermes mcp add qdrant-search \
--command python \
--args "-m,qdrant_search_mcp" \
--cwd /path/to/qdrant-search-mcp \
--env QDRANT_URL=https://... \
--env QDRANT_API_KEY=... \
--env COLLECTION_NAME=... \
--env OPENROUTER_API_KEY=... \
--env EMBEDDING_MODEL=qwen/qwen3-embedding-8bAvailable Tools
semantic_code_search
Search the codebase index using semantic (meaning-based) search.
Parameter | Type | Default | Description |
| string | required | Natural language description of what to find |
| int | 10 | Maximum number of results |
| string | "" | Override Qdrant collection name |
list_collections
List available Qdrant collections with stats (point count, vector dimensions).
Payload Format Support
The server supports multiple payload formats:
Field | Kilo Code | Generic |
File path |
|
|
Code content |
|
|
Start line |
|
|
End line |
|
|
License
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityAmaintenanceA high-performance MCP server for semantic search and codebase indexing using the Qdrant vector database. It features optimized embedding pipelines, AST-aware chunking, and git metadata enrichment for fast, privacy-focused local or remote search.Last updated33010MIT
- FlicenseAqualityDmaintenanceA local MCP server that provides semantic code search for Python codebases using tree-sitter for chunking and LanceDB for vector storage. It enables natural language queries to find relevant code snippets based on meaning rather than just text matching.Last updated33
- Flicense-qualityCmaintenanceA semantic code search MCP server that enables natural language queries against your codebase, supporting features like related file discovery and context expansion, all running locally.Last updated2
- AlicenseAqualityDmaintenanceMCP server for semantic code indexing using vector embeddings, enabling AI agents to maintain persistent memory of codebases through natural language queries and intelligent chunking.Last updated1974MIT
Related MCP Connectors
An MCP server that gives your AI access to the source code and docs of all public github repos
Local-first RAG engine with MCP server for AI agent integration.
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/webtoolbox/qdrant-search-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server