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