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

注意事项

⚠️ 重要提示

定期备份重要数据以防止意外丢失。

💡 使用建议

在生产环境中，请确保采取适当的安全防护措施。