MCP Server Qdrant Retrive

🚀 Qdrant 語義檢索 MCP 服務器

Qdrant 語義檢索 MCP 服務器是一款專為語義搜索打造的工具，它與 Qdrant 向量數據庫完美搭配，能夠高效地實現多集合語義搜索等功能，為用戶提供精準的語義搜索服務。

🚀 快速開始

在使用該服務器前，需要注意該服務器會連接到由 URL 指定的 Qdrant 實例。並且第一次檢索可能會較慢，因為 MCP 服務器會下載所需的嵌入模型。

✨ 主要特性

• 多集合語義搜索：支持同時在多個 Qdrant 集合中進行語義搜索。
• 支持多查詢：可以一次性輸入多個查詢文本進行搜索。
• 可配置結果數量：用戶能夠根據需求自定義檢索到的最相似文檔數量。
• 集合來源追蹤：能夠清晰地追蹤每個檢索結果來自哪個 Qdrant 集合。

📚 詳細文檔

🔗 API 文檔

工具

• qdrant_retrieve
  • 功能：根據多個查詢從多個 Qdrant 向量存儲集合中檢索語義相似的文檔。
  • 輸入:
    • collectionNames (string[])：要搜索的 Qdrant 集合名稱數組。
    • topK (number)：要檢索的最相似文檔數量（默認: 3）。
    • query (string[])：查詢文本數組。
  • 返回:
    • 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]
  --help                     顯示此幫助信息

環境變量
  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

⚠️ 重要提示

該服務器連接到由 URL 指定的 Qdrant 實例。第一次檢索可能會較慢，因為 MCP 服務器會下載所需的嵌入模型。

💡 使用建議

在使用前，請確保已經正確配置了 Qdrant 向量數據庫的 URL 和 API 密鑰。同時，根據實際需求調整命令行選項和 API 輸入參數。