Skip to main content
Glama
plixplox

mcp-qdrant-embedding-search

by plixplox
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Hybrid

mcp-qdrant-embedding-search

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.

Prerequisites

  • Node.js 18+

  • LMStudio running with an embedding model loaded (default: text-embedding-qwen3-embedding-4b)

  • Qdrant running with a collection containing your documents

Related MCP server: qdrant-mcp

Usage

With npx

{
  "mcpServers": {
    "qdrant-docs": {
      "command": "npx",
      "args": ["-y", "mcp-qdrant-embedding-search"],
      "env": {
        "QDRANT_URL": "http://localhost:6333",
        "QDRANT_COLLECTION": "my_docs",
        "LMSTUDIO_URL": "http://localhost:1234"
      }
    }
  }
}

With node (local)

git clone https://github.com/plixplox/mcp-qdrant-embedding-search.git
cd mcp-qdrant-embedding-search
npm install
npm run build
{
  "mcpServers": {
    "qdrant-docs": {
      "command": "node",
      "args": ["/path/to/mcp-qdrant-embedding-search/dist/index.js"],
      "env": {
        "QDRANT_COLLECTION": "my_docs"
      }
    }
  }
}

Tools

search_docs

Search documents by semantic similarity.

Parameter

Type

Required

Description

query

string

yes

Search query text

limit

number

no

Max results (default: 5)

collection

string

no

Qdrant collection (default: from config)

list_collections

List all available Qdrant collections. No parameters.

Configuration

All settings are configured via environment variables:

Variable

Default

Description

LMSTUDIO_URL

http://localhost:1234

LMStudio server URL

LMSTUDIO_EMBEDDING_MODEL

text-embedding-qwen3-embedding-4b

Embedding model name

QDRANT_URL

http://localhost:6333

Qdrant server URL

QDRANT_API_KEY

—

Qdrant API key (optional)

QDRANT_COLLECTION

documents

Default collection to search

SEARCH_LIMIT

5

Default number of results

TOOL_SEARCH_NAME

search_docs

Custom name for the search tool

TOOL_SEARCH_DESCRIPTION

Search documentation by semantic similarity...

Custom description for the search tool

TOOL_LIST_NAME

list_collections

Custom name for the list tool

TOOL_LIST_DESCRIPTION

List all available Qdrant collections

Custom description for the list tool

Custom tool descriptions

Tool names and descriptions are visible to the LLM and affect when it decides to call them. Customize them to match your use case:

{
  "env": {
    "TOOL_SEARCH_NAME": "search_api_reference",
    "TOOL_SEARCH_DESCRIPTION": "Search the REST API reference. Use when you need endpoint specs, request/response schemas, or auth details."
  }
}

License

ISC

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

Resources

Related MCP Connectors

Related MCP Servers

  • MCP-Ragdocs

    qpd-v
    A
    license
    Not graded
    quality
    F
    maintenance
    A Model Context Protocol (MCP) server that enables semantic search and retrieval of documentation using a vector database (Qdrant). This server allows you to add documentation from URLs or local files and then search through them using natural language queries.
    33 npm
    136
    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-server-qdrant

    vaporif
    A
    license
    Not graded
    quality
    C
    maintenance
    MCP server for Qdrant vector database with local BERT embeddings. Enables semantic search and vector storage operations through natural language.
    MIT