MCP Qdrant Server With Qdrant Db

🚀 基於 MCP 協議的代碼片段管理服務器與 Qdrant 向量數據庫結合使用

本項目創新性地將 MCP（模型控制協議）服務器與 Qdrant 向量數據庫深度融合，成功構建了一個高效的代碼片段存儲與檢索系統。該系統不僅能實現代碼片段的有效管理，還支持基於自然語言和語義的搜索，為開發者提供了極大的便利。

✨ 主要特性

• 代碼片段的保存與管理：方便地將代碼片段存儲到系統中，並進行有效的管理。
• 基於自然語言的代碼搜索：用戶可以使用自然語言進行代碼搜索，提高搜索效率。
• 通過語義搜索查找相關代碼：利用語義搜索技術，精準查找與需求相關的代碼。
• 支持 Server - Sent Events（SSE）數據傳輸協議：確保數據的即時傳輸。

📦 安裝指南

先決條件

• Docker 容器引擎
• Docker Compose 服務編排工具

安裝與運行

步驟 1：克隆代碼倉庫

git clone <repository-url>
cd <repository-name>

步驟 2：啟動服務組件

docker-compose up -d

步驟 3：檢查服務狀態

docker-compose ps

服務訪問地址

• Qdrant 管理界面：http://localhost:6333/dashboard
• MCP Server 接口：http://localhost:8000
• 對於 cursor 等 AI 開發環境的配置，可參考如下 JSON 格式：

    "qdrant": {
      "url": "http://localhost:8000/sse"
    },

📚 詳細文檔

系統架構

• Qdrant：向量數據庫服務器（端口：6333，6334）
• MCP 服務器：代碼片段管理服務器（端口：8000）
• 嵌入式模型：默認使用 sentence-transformers/all-MiniLM-L6-v2

MCP 工具集

Qdrant MCP 服務器提供了以下功能模塊：

1. qdrant - store

• 功能描述：將信息保存至 Qdrant 數據庫
• 輸入參數：
  • information（字符串）：待存儲的信息內容
  • metadata（JSON 格式）：可選的元數據信息
• 返回結果：存儲確認消息

2. qdrant - find

• 功能描述：在 Qdrant 數據庫中搜索相關信息
• 輸入參數：
  • query（字符串）：用於執行搜索的查詢語句
• 返回結果：Qdrant 數據庫中存儲的信息，按獨立消息格式呈現

環境變量配置

Qdrant 相關變量

• RUST_LOG：設置運行時日誌級別（默認值為 info）

MCP 服務器相關變量

• QDRANT_URL：指定 Qdrant 服務的網絡地址
• COLLECTION_NAME：定義數據集合名稱
• EMBEDDING_MODEL：選擇使用的嵌入式模型
• TOOL_STORE_DESCRIPTION：存儲功能的描述信息
• TOOL_FIND_DESCRIPTION：搜索功能的描述信息

數據持久化

所有存儲的數據將長期保存在 ./qdrant_storage 目錄下。

服務管理操作

查看運行日誌

docker-compose logs

停止服務運行

docker-compose down

注意事項

⚠️ 重要提示

定期備份重要數據以防止意外丟失。

💡 使用建議

在生產環境中，請確保採取適當的安全防護措施。