Better Qdrant MCP Server
Overview
Better Qdrant MCP Server is a Model Context Protocol (MCP) server designed to enhance the functionality of the Qdrant vector database, providing tools for managing collections, adding documents, and performing semantic searches.
To use the server, install it via npm or npx, configure the necessary environment variables in a .env file, and then run commands to manage collections and documents.
- List all available Qdrant collections - Add documents to collections with various embedding services - Perform semantic searches across the vector database - Delete collections from the Qdrant database
- Managing large datasets in Qdrant for machine learning applications.
- Enhancing search capabilities in applications using vector embeddings.
- Facilitating document management and retrieval in data-driven projects.
Add to your AI client
Use these steps to connect Better Qdrant MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"better-qdrant-mcp-server-wrediam": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-better-qdrant-mcp-server-wrediam"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"better-qdrant-mcp-server-wrediam": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-better-qdrant-mcp-server-wrediam"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"better-qdrant-mcp-server-wrediam": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-better-qdrant-mcp-server-wrediam"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"better-qdrant-mcp-server-wrediam": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-better-qdrant-mcp-server-wrediam"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"better-qdrant-mcp-server-wrediam": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-better-qdrant-mcp-server-wrediam"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"better-qdrant-mcp-server-wrediam": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-better-qdrant-mcp-server-wrediam"
]
}
}
}FAQ
What are the requirements to run the server?
You need Node.js >= 18.0.0 and a running Qdrant server, along with API keys for the embedding services you wish to use.
How do I configure the server?
Configuration is done through environment variables set in a `.env` file in your project root.
Can I use local embedding models?
Yes, the server supports local embedding models through Ollama and FastEmbed.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":3871,"uuid":"b182be83-f0f6-46c8-8b0a-1bc7d77da0eb","name":"better-qdrant-mcp-server","title":"Better Qdrant MCP Server","description":"","avatar_url":"https://avatars.githubusercontent.com/u/24812768?v=4","created_at":"$D2025-03-22T04:40:30.787Z","updated_at":"$D2025-03-22T04:51:59.420Z","status":"created","author_name":"wrediam","author_avatar_url":"https://avatars.githubusercontent.com/u/24812768?v=4","tags":"better-qdrant,mcp-server,vector-database","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/wrediam/better-qdrant-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"0\",\"license\":\"MIT license\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-21 22:02:09\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]