qdrant-mcp-local
2025.04.10
1
Shell向量搜索本地开发环境数据库开发效率
qdrant-mcp-local 是一个用于在本地环境中快速启动 Qdrant 向量搜索引擎和 MCP-server-qdrant 的 Docker Compose 配置。它支持 Model Context Protocol (MCP) 服务器与 Qdrant 向量数据库的集成，提供高效的向量搜索和数据处理能力。
View on GitHub
Overview
基本能力
产品定位
qdrant-mcp-local 是一个本地开发环境工具，旨在简化 Qdrant 向量搜索引擎和 MCP-server-qdrant 的部署和使用。
核心功能
- Qdrant 向量搜索引擎：提供高效的向量搜索能力。
- MCP-server-qdrant：支持 Model Context Protocol (MCP)，与 Qdrant 向量数据库集成，提供数据处理和搜索功能。
适用场景
- 本地开发环境中快速部署 Qdrant 和 MCP-server-qdrant。
- 需要高效向量搜索和数据处理的开发项目。
- 与 Claude Desktop 和 Cursor 等工具集成使用。
工具列表
- Docker Compose：用于快速启动和管理容器化服务。
- debug.sh：用于调试和排查环境问题。
常见问题解答
- 端口冲突：如果 6333 或 8000 端口已被占用，可以通过修改
.env文件更改端口。 - 磁盘空间不足：确保 Docker 有足够的磁盘空间。
- 容器启动失败：使用
debug.sh脚本或手动检查日志 (docker compose logs mcp-server) 进行排查。
使用教程
使用依赖
- Docker：确保已安装 Docker。
- Docker Compose V2：通常已包含在最新版 Docker 中。
安装教程
- 克隆仓库：
git clone https://github.com/hirokita117/qdrant-mcp-local.git
cd qdrant-mcp-local
- 创建数据目录：
mkdir -p data
- 启动服务：
docker compose up -d
调试方式
- 使用调试脚本：
chmod +x debug.sh
./debug.sh
- 手动检查日志：
docker compose logs mcp-server
- 重新构建容器：
docker compose down
docker compose build --no-cache
docker compose up -d