集成 Qdrant 的 MCP 服务器

本项目集成了 Qdrant 向量数据库和 MCP（模型控制协议）服务器，用于存储和检索代码片段。

功能

• 代码片段的存储和管理
• 基于自然语言的代码搜索
• 通过语义搜索查找相关代码
• 支持 SSE（服务器发送事件）传输方式

系统构成

• Qdrant: 向量数据库服务器 (端口: 6333, 6334)
• MCP Server: 代码片段管理服务器 (端口: 8000)
• 嵌入模型: (默认)sentence-transformers/all-MiniLM-L6-v2

MCP 工具

QDRANT MCP 服务器 提供以下工具：

1. qdrant-store

• 功能: 将信息存储到 Qdrant 数据库
• 输入:
  • information (string): 要存储的信息
  • metadata (JSON): 可选的元数据
• 返回: 存储确认消息

2. qdrant-find

• 功能: 从 Qdrant 数据库中搜索相关信息
• 输入:
  • query (string): 用于搜索的查询
• 返回: 以单独消息的形式返回存储在 Qdrant 数据库中的信息

开始使用

必要条件

• Docker
• Docker Compose

安装及运行

1. 克隆仓库

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

2. 启动服务

docker-compose up -d

3. 检查服务状态

docker-compose ps

服务访问

• Qdrant UI: http://localhost:6333/dashboard
• MCP Server: http://localhost:8000
• 在 cursor 等 ai ide 中设置时，可以添加以下 json 格式：

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

环境变量

Qdrant

• RUST_LOG: 日志级别 (默认值: info)

MCP Server

• QDRANT_URL: Qdrant 服务器地址
• COLLECTION_NAME: 集合名称
• EMBEDDING_MODEL: 嵌入模型
• TOOL_STORE_DESCRIPTION: 存储工具描述
• TOOL_FIND_DESCRIPTION: 搜索工具描述

数据存储

数据将永久存储在 ./qdrant_storage 目录中。

服务管理

查看日志

docker-compose logs -f

停止服务

docker-compose down

注意事项

• 为了数据备份，请定期备份 qdrant_storage 目录。
• 在生产环境中，请添加适当的安全设置。