Qdrant Retrieve MCP Server

基本能力

产品定位

mcp-server-qdrant-retrieve 是一个专门用于语义搜索的 MCP 服务器，利用 Qdrant 向量数据库实现高效的文档检索。

核心功能

• 语义搜索：支持跨多个 Qdrant 集合进行语义搜索。
• 多查询支持：可以同时处理多个查询输入。
• 可配置结果数量：用户可以指定返回的相似文档数量。
• 集合源跟踪：能够追踪检索结果的来源集合。

适用场景

• 需要高效语义搜索的应用场景。
• 多集合文档检索需求。
• 需要可配置检索结果数量的场景。

工具列表

• qdrant_retrieve
• 功能：从多个 Qdrant 向量存储集合中检索语义相似的文档。
• 输入参数：
  • collectionNames：要搜索的 Qdrant 集合名称数组。
  • topK：要检索的相似文档数量（默认：3）。
  • query：查询文本数组。
• 返回结果：
  • results：检索到的文档数组，包含查询、集合名称、文档文本内容和相似度分数。

常见问题解答

• 首次检索慢：首次检索需要下载嵌入模型，后续检索会更快。
• Qdrant 连接：需要确保 Qdrant 实例的 URL 正确且可访问。

使用教程

使用依赖

需要安装 Node.js 和 npm。

安装教程

1. 通过 npm 安装：

npm install -y @gergelyszerovay/mcp-server-qdrant-retrive

1. 配置 Claude Desktop： 在 claude_desktop_config.json 中添加以下配置：

{
  "mcpServers": {
    "qdrant": {
      "command": "npx",
      "args": ["-y", "@gergelyszerovay/mcp-server-qdrant-retrive"],
      "env": {
        "QDRANT_API_KEY": "your_api_key_here"
      }
    }
  }
}

调试方式

启动服务器时可以使用以下命令进行调试：

mcp-qdrant --enableHttpTransport
mcp-qdrant --mcpHttpPort=3005 --restHttpPort=3006
mcp-qdrant --qdrantUrl=http://qdrant.example.com:6333
mcp-qdrant --embeddingModelType=Xenova/all-MiniLM-L6-v2

命令行选项

• --enableHttpTransport：启用 HTTP 传输（默认：false）
• --enableStdioTransport：启用 stdio 传输（默认：true）
• --enableRestServer：启用 REST API 服务器（默认：false）
• --mcpHttpPort=<port>：MCP HTTP 服务器端口（默认：3001）
• --restHttpPort=<port>：REST HTTP 服务器端口（默认：3002）
• --qdrantUrl=<url>：Qdrant 向量数据库 URL（默认：http://localhost:6333）
• --embeddingModelType=<type>：使用的嵌入模型类型（默认：Xenova/all-MiniLM-L6-v2）

环境变量

• QDRANT_API_KEY：用于认证 Qdrant 实例的 API 密钥（可选）

许可证

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