Qdrant Retrieve

🚀 Qdrant 检索 MCP 服务器

Qdrant 检索 MCP 服务器是一款用于语义搜索的工具，借助 Qdrant 向量数据库，能高效实现多集合语义搜索等功能，为用户提供精准的搜索结果。

✨ 主要特性

• 多集合语义搜索：可同时在多个集合中进行语义搜索，提升搜索的全面性。
• 支持多查询：允许用户输入多个查询文本，满足多样化的搜索需求。
• 可配置的结果数量：用户能根据自身需求，灵活配置要检索的最相似文档数量。
• 收集来源跟踪：方便用户了解检索结果的来源集合。

⚠️ 重要提示

该服务器连接到由 URL 指定的 Qdrant 实例。

⚠️ 重要提示

第一次检索可能会较慢，因为 MCP 服务器会下载所需的嵌入模型。

📚 详细文档

📄 API 文档

工具

• qdrant_retrieve
  • 功能：根据多个查询从多个 Qdrant 向量存储集合中检索语义相似的文档。
  • 输入：
    • collectionNames (字符串[]): 要搜索的 Qdrant 集合名称数组。
    • topK (数字): 要检索的最相似文档数量（默认: 3）。
    • query (字符串[]): 查询文本数组。
  • 返回：
    • results: 检索到的文档数组，包含:
      • query: 产生此结果的查询。
      • collectionName: 此结果来源的集合名称。
      • text: 文档正文内容。
      • score: 相似度分数（范围在 0 到 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"
      }
    }
  }
}

命令行选项

语义搜索用的 Qdrant 向量数据库的 MCP 服务器。

选项
  --enableHttpTransport      启用 HTTP 传输 [默认: false]
  --enableStdioTransport     启用标准输入输出传输 [默认: true]
  --enableRestServer         启用 REST API 服务器 [默认: false]
  --mcpHttpPort=<端口>       MCP HTTP 服务器的端口号 [默认: 3001]
  --restHttpPort=<端口>      REST HTTP 服务器的端口号 [默认: 3002]
  --qdrantUrl=<URL>          Qdrant 向量数据库的 URL [默认: http://localhost:6333]
  --embeddingModelType=<类型> 要使用的嵌入模型类型 [默认: Xenova/all-MiniLM-L6-v2]
  --帮助                     显示此帮助消息

环境变量
  QDRANT_API_KEY            认证的 Qdrant 实例 API 密钥（可选）

示例
  $ 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