Better Qdrant MCP Server

基本能力

产品定位

Better Qdrant MCP Server 是一个用于增强 Qdrant 向量数据库功能的 MCP 服务器，主要用于管理和操作向量数据库中的集合和文档。

核心功能

• List Collections: 查看所有可用的 Qdrant 集合
• Add Documents: 处理并将文档添加到 Qdrant 集合中，支持多种嵌入服务
• Search: 在向量数据库中进行语义搜索
• Delete Collection: 从 Qdrant 数据库中删除集合

适用场景

• 需要管理和操作 Qdrant 向量数据库的开发项目
• 需要进行语义搜索的应用场景
• 需要集成多种嵌入服务的开发环境

工具列表

• list_collections: 列出所有可用的 Qdrant 集合
• add_documents: 添加文档到指定的 Qdrant 集合
• search: 在指定的集合中进行语义搜索
• delete_collection: 删除指定的 Qdrant 集合

常见问题解答

• 依赖要求: Node.js >= 18.0.0 和运行的 Qdrant 服务器（本地或远程）
• API 密钥: 需要为使用的嵌入服务提供 API 密钥

使用教程

使用依赖

1. 确保已安装 Node.js >= 18.0.0
2. 确保有一个运行的 Qdrant 服务器（本地或远程）

安装教程

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

调试方式

列出集合

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"
}

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。