📦

mcp-server-qdrant-rs

MCP server for Qdrant vector database with local embedding support

0 installs

Trust: 37 — Low

Rag

Ask AI about mcp-server-qdrant-rs

I know everything about mcp-server-qdrant-rs. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

mcp-server-qdrant

Rust MCP server for Qdrant with local BERT embeddings. Single binary, no Python.

Why not the official Python one?

ONNX Python wheels are painful to package in Nix (especially aarch64-linux). This is a Rust rewrite with Nix-native packaging and a pure-Rust default backend (Candle) that has zero native dependencies.

Usage

Claude Desktop / Claude Code

With uvx (recommended):

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

With rvx:

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

Other installation methods

With Nix:

nix run github:vaporif/mcp-server-qdrant

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

As a flake input:

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

With cargo:

cargo install mcp-server-qdrant

From releases:

Download a prebuilt binary from GitHub Releases.

With 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 Transport

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

Debugging

RUST_LOG=debug mcp-server-qdrant

Environment Variables

Variable	Default	Description
`QDRANT_URL`	—	Qdrant server URL
`QDRANT_API_KEY`	—	Qdrant API key
`QDRANT_LOCAL_PATH`	—	Local storage path (instead of URL)
`COLLECTION_NAME`	—	Default collection name
`QDRANT_SEARCH_LIMIT`	10	Max search results
`QDRANT_READ_ONLY`	false	Read-only mode
`EMBEDDING_MODEL`	sentence-transformers/all-MiniLM-L6-v2	Model name
`MCP_TRANSPORT`	stdio	`stdio`, `sse`, `streamable-http`
`HOST`	127.0.0.1	Bind host for SSE/HTTP
`PORT`	8000	Bind port for SSE/HTTP

Embedding Backends

Feature	Description
`candle` (default)	Pure Rust. No native deps.
`onnx`	ONNX Runtime. Provide `ORT_DYLIB_PATH`.
`onnx-fetch`	ONNX with auto-download.

Development

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)

License

MIT