向量搜索本地开发环境

用于在本地环境中快速部署Qdrant向量搜索引擎和MCP-server-qdrant服务的Docker Compose配置。

  • by hirokita117
  • Shell
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 hirokita117/qdrant-mcp-local

使用说明

qdrant mcp本地

在本地环境中Qdrant打开MCP-server-qdrant为了简单地站起来Docker Compose设定。

概要

此存储库包含以下组件:

  1. Qdrant -向量搜索引擎
  2. MCP服务器qdrant - 模型上下文协议(MCP)服务器。Qdrant支持与向量数据库的协作。

设置方法

前提条件

  • 码头工人
  • Docker Compose V2 (当前Docker中通常包含)

使用方法

  1. 克隆存储库:
git clone https://github.com/hirokita117/qdrant-mcp-local.git
cd qdrant-mcp-local
  1. 创建用于保存数据的目录:
mkdir -p data
  1. Docker Compose使用启动环境(第一次构建需要一些时间):
docker compose up -d

这将启动以下服务:

  • 问题:http://localhost:6333
  • MCP服务器:http://localhost:8000
  1. 要停止环境:
docker compose down

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

自定义设置

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

故障排除

如果容器未启动

  1. 运行调试脚本:
chmod +x debug.sh
./debug.sh

此脚本显示有关环境的详细信息和错误的详细信息。

  1. 手动检查日志:
docker compose logs mcp-server
  1. 容器重建:

要完全重建环境:

docker compose down
docker compose build --no-cache
docker compose up -d
  1. 常见问题和解决方案:
  • 端口冲突:如果已使用6333或8000个端口.env请在文件中指定其他端口。
  • 磁盘空间: Docker中描述的场景,使用以下步骤创建明细表,以便在概念设计中分析体量的体积。
  • Docker守护程序: Docker请检查守护程序是否正常运行。

单击功能区上的docs/USAGE.md来修改标记元素的显示属性。

使用例

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

许可证

这个项目是原来的Qdrant打开MCP-server-qdrant的规格化距离的幂函数。