Qdrant Retrieve

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=          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
  • 0 关注
  • 0 收藏,8 浏览
  • system 提出于 2025-09-23 09:18

相似服务问题