MCP Server with Qdrant

使用 Qdrant 的 MCP 服务

本项目将 Qdrant 向量数据库与 MCP（Model Control Protocol）服务集成，用于存储和搜索代码片段。

功能

• 存储和管理代码片段
• 基于自然语言搜索代码
• 通过语义搜索查找相关代码
• 支持 SSE（Server-Sent Events）传输方式

系统 구성

• Qdrant：向量数据库服务器（端口：6333、6334）
• MCP 服务：代码片段管理服务器（端口：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 服务：http://localhost:8000
• 配置到 cursor 等 AI IDE 时，可以按以下 JSON 格式添加

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

环境变量

Qdrant

• RUST_LOG：日志级别（默认值：info）

MCP 服务

• QDRANT_URL：Qdrant 服务地址
• COLLECTION_NAME：集合名称
• EMBEDDING_MODEL：嵌入模型
• TOOL_STORE_DESCRIPTION：存储工具说明
• TOOL_FIND_DESCRIPTION：搜索工具说明

数据存储

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

服务管理

查看日志

docker-compose logs -f

停止服务

docker-compose down

注意事项

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