Qdrant MCP Local

🚀 qdrant-mcp-local

本项目提供了一个Docker Compose配置，可帮助你在本地环境中轻松启动Qdrant和MCP-server-qdrant。通过简单的步骤，你就能快速搭建起向量搜索和模型上下文协议服务。

🚀 快速开始

先决条件

• Docker
• Docker Compose V2（通常已包含在Docker中）

使用方法

1. 克隆仓库：

git clone https://github.com/hirokita117/qdrant-mcp-local.git
cd qdrant-mcp-local

2. 创建数据存储目录：

mkdir -p data

3. 使用Docker Compose启动环境（首次构建可能需要一点时间）：

docker compose up -d

这将启动以下服务：

• Qdrant: http://localhost:6333
• MCP Server: http://localhost:8000

4. 停止环境：

docker compose down

Qdrant的数据存储在./data目录中，因此即使容器停止，信息也会保留。

✨ 主要特性

此仓库包含以下组件：

1. Qdrant - 向量搜索引擎
2. MCP-server-qdrant - 模型上下文协议（MCP）服务器。支持与Qdrant向量数据库的集成。

📦 安装指南

先决条件

• Docker
• Docker Compose V2（通常已包含在Docker中）

使用方法

1. 仓库克隆：

git clone https://github.com/hirokita117/qdrant-mcp-local.git
cd qdrant-mcp-local

2. 数据存储目录创建：

mkdir -p data

3. 使用Docker Compose启动环境（首次构建可能需要一点时间）：

docker compose up -d

这将启动以下服务：

• Qdrant: http://localhost:6333
• MCP Server: http://localhost:8000

4. 环境停止：

docker compose down

Qdrant的数据存储在./data目录中，因此即使容器停止，信息也会保留。

设置的自定义

通过编辑.env文件可以修改环境变量。

💻 使用示例

MCP服务器的端点

• MCP SSE端点: http://localhost:8000/sse

在Claude Desktop中的设置示例

在Claude Desktop中使用时，将以下内容添加到claude_desktop_config.json：

{
  "mcpServers": {
    "qdrant": {
      "command": "curl",
      "args": ["-N", "http://localhost:8000/sse"],
      "transport": "sse"
    }
  }
}

在Cursor中的设置示例

在Cursor中使用时，在MCP服务器设置中指定以下URL：

http://localhost:8000/sse

🔧 技术细节

故障排除

容器无法启动时

1. 运行调试脚本：

chmod +x debug.sh
./debug.sh

该脚本将显示环境详细信息和错误细节。 2. 手动查看日志：

docker compose logs mcp-server

3. 重新构建容器： 要完全重新构建：

docker compose down
docker compose build --no-cache
docker compose up -d

4. 常见问题与解决方案：

• 端口冲突：如果6333或8000端口已被占用，请在.env文件中指定其他端口。
• 磁盘空间：确保Docker使用的磁盘空间充足。
• Docker守护进程：确认Docker守护程序正常运行。

有关详细故障排除信息，请参阅docs/USAGE.md。

📄 许可证

此项目遵循原始的Qdrant和MCP-server-qdrant许可。