Better Qdrant MCP Server
更好的 Qdrant MCP 服务器
用于增强 Qdrant 矢量数据库功能的模型上下文协议 (MCP) 服务器。该服务器提供用于管理 Qdrant 集合、添加文档和执行语义搜索的工具。
特征
列出收藏集:查看所有可用的 Qdrant 收藏集
添加文档:使用各种嵌入服务处理文档并将其添加到 Qdrant 集合
搜索:在矢量数据库中执行语义搜索
删除集合:从 Qdrant 数据库中删除集合
Related MCP server: doc-lib-mcp
安装
npm install -g better-qdrant-mcp-server或者直接通过 npx 使用:
npx better-qdrant-mcp-server配置
服务器使用环境变量进行配置。你可以在项目根目录下的.env文件中设置这些变量:
# Qdrant Configuration
QDRANT_URL=http://localhost:6333
QDRANT_API_KEY=your_api_key_if_needed
# Embedding Service API Keys
OPENAI_API_KEY=your_openai_api_key
OPENROUTER_API_KEY=your_openrouter_api_key
OLLAMA_ENDPOINT=http://localhost:11434支持的嵌入服务
OpenAI :需要 API 密钥
OpenRouter :需要 API 密钥
Ollama :本地嵌入模型(默认端点: http://localhost:11434 )
FastEmbed :本地嵌入模型
与 Claude 一起使用
要将此 MCP 服务器与 Claude 一起使用,请将其添加到您的 MCP 设置配置文件中:
{
"mcpServers": {
"better-qdrant": {
"command": "npx",
"args": ["better-qdrant-mcp-server"],
"env": {
"QDRANT_URL": "http://localhost:6333",
"QDRANT_API_KEY": "your_api_key_if_needed",
"DEFAULT_EMBEDDING_SERVICE": "ollama",
"OPENAI_API_KEY": "your_openai_api_key",
"OPENAI_ENDPOINT": "https://api.openai.com/v1",
"OPENROUTER_API_KEY": "your_openrouter_api_key",
"OPENROUTER_ENDPOINT": "https://api.openrouter.com/v1",
"OLLAMA_ENDPOINT": "http://localhost:11434",
"OLLAMA_MODEL": "nomic-embed-text"
}
}
}
}示例命令
列表集合
use_mcp_tool
server_name: better-qdrant
tool_name: list_collections
arguments: {}添加文档
use_mcp_tool
server_name: better-qdrant
tool_name: add_documents
arguments: {
"filePath": "/path/to/your/document.pdf",
"collection": "my-collection",
"embeddingService": "openai",
"chunkSize": 1000,
"chunkOverlap": 200
}搜索
use_mcp_tool
server_name: better-qdrant
tool_name: search
arguments: {
"query": "your search query",
"collection": "my-collection",
"embeddingService": "openai",
"limit": 5
}删除收藏集
use_mcp_tool
server_name: better-qdrant
tool_name: delete_collection
arguments: {
"collection": "my-collection"
}要求
Node.js >= 18.0.0
正在运行的 Qdrant 服务器(本地或远程)
您要使用的嵌入服务的 API 密钥
执照
麻省理工学院
Available Tools
4 toolsadd_documentsC
Add documents to a Qdrant collection with specified embedding service
Inputs: collection (required), embeddingService (required), filePath (required), chunkOverlap, +1 more.
delete_collectionC
Delete a Qdrant collection
Inputs: collection (required).
list_collectionsB
List all available Qdrant collections
Inputs: no named parameters.
searchC
Search for similar documents in a collection
Inputs: collection (required), embeddingService (required), query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: add_documents handles document insertion, delete_collection removes collections, list_collections enumerates them, and search performs similarity queries. There is no overlap in functionality, making tool selection straightforward.
All tools follow a consistent verb_noun pattern (add_documents, delete_collection, list_collections, search). The naming is uniform and predictable, with no deviations in style or convention.
With only 4 tools, the set feels thin for a vector database server, lacking operations like collection creation, document updates, or deletion. While the tools cover basic CRUD aspects, the scope is limited and may require workarounds for full functionality.
There are significant gaps in the tool surface for a Qdrant server: no create_collection tool, no update or delete document operations, and no management of embeddings or configurations. This incomplete coverage will likely cause agent failures in common workflows.
Maintenance
Related MCP Connectors
The Needle MCP server enables semantic search on documents stored in files like PDFs, DOCX, and XLSX by connecting AI applications to external data sources. It provides capabilities to create and manage document collections, perform natural language searches on stored content, and retrieve relevant information without requiring exact keyword matches.
An MCP server for search and retrieval over a local LanceDB database
A Model Context Protocol server for Wix AI tools
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that enables semantic search and retrieval of documentation using a vector database (Qdrant). This server allows you to add documentation from URLs or local files and then search through them using natural language queries.135Apache 2.0
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server for ingesting, chunking and semantically searching documentation files, with support for markdown, Python, OpenAPI, HTML files and URLs.-
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables intelligent document search and retrieval from PDF collections, providing semantic search capabilities powered by OpenAI embeddings and ChromaDB vector storage.13MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server for Retrieval-Augmented Generation (RAG) operations. It provides tools for building and querying vector-based knowledge bases from document collections, enabling semantic search and document retrieval capabilities.15 PyPI3MIT