Skip to main content
Glama
vaporif

mcp-server-qdrant

by vaporif
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Rust
Hybrid

mcp-server-qdrant

CI

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.

Related MCP server: qdrant-mcp

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"
      }
    }
  }
}

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MCP Server for Qdrant

    Jimmy974
    A
    license
    Not graded
    quality
    D
    maintenance
    A Machine Control Protocol (MCP) server that enables storing and retrieving information from a Qdrant vector database with semantic search capabilities.
    Apache 2.0

  • qdrant-mcp

    msstnk
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for document ingestion and semantic search on Qdrant. Enables ingesting local documents, generating embeddings with OpenAI, and performing vector search with metadata filters.
    Apache 2.0

  • mcp-qdrant-embedding-search

    plixplox
    A
    license
    Not graded
    quality
    C
    maintenance
    MCP server that searches documents in Qdrant using embeddings from LMStudio. Takes a text query, converts it to a vector via LMStudio's OpenAI-compatible API, and performs semantic search in Qdrant.
    15 npm
    ISC