Qdrant向量搜索服务器

基于Rust的Qdrant向量搜索服务器,支持本地BERT嵌入,提供单二进制部署方案。

  • by vaporif
  • Rust
  • 混合部署
  • 更新于
在 GitHub 查看 vaporif/mcp-server-qdrant

使用说明

mcp服务器qdrant

用于Qdrant的Rust-MCP服务器,带有本地BERT嵌入。单二进制,没有Python。

为什么不呢 官方Python one?

ONNX Python轮在Nix中打包很痛苦(尤其是aarch64-linux)。这是一个使用Nix原生打包和零原生依赖的纯Rust默认后端(Candle)的Rust重写。

用法

克劳德桌面/克劳德代码

随着 uvx (推荐):

{
  "mcpServers": {
    "qdrant": {
      "command": "uvx",
      "args": ["mcp-server-qdrant-rs"],
      "env": {
        "QDRANT_URL": "http://localhost:6334",
        "COLLECTION_NAME": "my-collection"
      }
    }
  }
}

随着 瑞维克斯:

{
  "mcpServers": {
    "qdrant": {
      "command": "rvx",
      "args": ["mcp-server-qdrant"],
      "env": {
        "QDRANT_URL": "http://localhost:6334",
        "COLLECTION_NAME": "my-collection"
      }
    }
  }
}
Other installation methods

对于Nix:

nix run github:vaporif/mcp-server-qdrant

# ONNX backend
nix run github:vaporif/mcp-server-qdrant#onnx

作为薄片输入:

{
  inputs.mcp-server-qdrant.url = "github:vaporif/mcp-server-qdrant";
  nixpkgs.overlays = [ mcp-server-qdrant.overlays.default ];
}

货物:

cargo install mcp-server-qdrant

从发布:

从下载预构建的二进制文件 GitHub 发布.

使用Docker:

docker build -t mcp-server-qdrant .
docker run -p 8000:8000 -e QDRANT_URL=http://host.docker.internal:6334 -e COLLECTION_NAME=my-collection mcp-server-qdrant

HTTP传输

mcp-server-qdrant --transport streamable-http --port 8000

调试

RUST_LOG=debug mcp-server-qdrant

环境变量

变量 默认值 描述
QDRANT_URL -- Qdrant服务器URL
QDRANT_API_KEY - Qdrant API密钥
QDRANT_LOCAL_PATH -- 本地存储路径(而不是URL)
COLLECTION_NAME -- 默认集合名称
QDRANT_SEARCH_LIMIT 10 最大搜索结果
QDRANT_READ_ONLY false 只读模式
EMBEDDING_MODEL 句子转换器/全MiniLM-L6-v2 型号名称
MCP_TRANSPORT 站立 stdio, sse, streamable-http
HOST 127.0.0.1 绑定SSE/HTTP主机
PORT 8000 绑定SSE/HTTP端口

嵌入后端

特性 描述
candle (默认) 纯Rust。没有本地deps。
onnx ONNX运行时。提供 ORT_DYLIB_PATH.
onnx-fetch 具有自动下载功能的ONNX。

发展

nix develop    # dev shell
just check     # clippy + test + fmt + taplo + typos
just test      # run tests
just lint      # clippy + fmt
just deny      # dependency audit
just e2e       # e2e tests (needs Qdrant)

许可证

麻省理工学院