Files

Kacper Łukawski b9f773e99c Handle parameters with environmental variables only (#24 )

* Switch to Typer to read the CLI parameters and options

* Rely on environmental variables only

* Fix tests

* Update README

2025-03-10 16:36:31 +01:00

5.1 KiB

Raw Blame History

mcp-server-qdrant: A Qdrant MCP server

The Model Context Protocol (MCP) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. Whether you’re building an AI-powered IDE, enhancing a chat interface, or creating custom AI workflows, MCP provides a standardized way to connect LLMs with the context they need.

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Overview

A basic Model Context Protocol server for keeping and retrieving memories in the Qdrant vector search engine. It acts as a semantic memory layer on top of the Qdrant database.

Components

Tools

qdrant-store-memory
- Store a memory in the Qdrant database
- Input:
  - information (string): Memory to store
- Returns: Confirmation message
qdrant-find-memories
- Retrieve a memory from the Qdrant database
- Input:
  - query (string): Query to retrieve a memory
- Returns: Memories stored in the Qdrant database as separate messages

Installation in Claude Desktop

Using mcp (recommended)

When using mcp no specific installation is needed to directly run mcp-server-qdrant.

mcp install src/mcp_server_qdrant/server.py \
  -v QDRANT_URL="http://localhost:6333" \
  -v QDRANT_API_KEY="your_api_key" \
  -v COLLECTION_NAME="my_collection" \
  -v EMBEDDING_MODEL="sentence-transformers/all-MiniLM-L6-v2"

Installing via Smithery

To install Qdrant MCP Server for Claude Desktop automatically via Smithery:

npx @smithery/cli install mcp-server-qdrant --client claude

Manual configuration

To use this server with the Claude Desktop app, add the following configuration to the "mcpServers" section of your claude_desktop_config.json:

{
  "qdrant": {
    "command": "uvx",
    "args": ["mcp-server-qdrant"],
    "env": {
      "QDRANT_URL": "http://localhost:6333",
      "QDRANT_API_KEY": "your_api_key",
      "COLLECTION_NAME": "your_collection_name",
      "EMBEDDING_MODEL": "sentence-transformers/all-MiniLM-L6-v2"
    }
  }
}

For local Qdrant mode:

{
  "qdrant": {
    "command": "uvx",
    "args": ["mcp-server-qdrant"],
    "env": {
      "QDRANT_LOCAL_PATH": "/path/to/qdrant/database",
      "COLLECTION_NAME": "your_collection_name",
      "EMBEDDING_MODEL": "sentence-transformers/all-MiniLM-L6-v2"
    }
  }
}

This MCP server will automatically create a collection with the specified name if it doesn't exist.

By default, the server will use the sentence-transformers/all-MiniLM-L6-v2 embedding model to encode memories. For the time being, only FastEmbed models are supported.

Support for other tools

This MCP server can be used with any MCP-compatible client. For example, you can use it with Cursor, which provides built-in support for the Model Context Protocol.

Environment Variables

The configuration of the server is done using environment variables:

QDRANT_URL: URL of the Qdrant server, e.g. http://localhost:6333
QDRANT_API_KEY: API key for the Qdrant server (optional, depends on Qdrant server configuration)
COLLECTION_NAME: Name of the collection to use (required)
EMBEDDING_MODEL: Name of the embedding model to use (default: sentence-transformers/all-MiniLM-L6-v2)
EMBEDDING_PROVIDER: Embedding provider to use (currently only "fastembed" is supported)
QDRANT_LOCAL_PATH: Path to the local Qdrant database (alternative to QDRANT_URL)

Note: You cannot provide both QDRANT_URL and QDRANT_LOCAL_PATH at the same time.

Important

Command-line arguments are not supported anymore! Please use environment variables for all configuration.

Contributing

If you have suggestions for how mcp-server-qdrant could be improved, or want to report a bug, open an issue! We'd love all and any contributions.

Testing `mcp-server-qdrant` locally

The MCP inspector is a developer tool for testing and debugging MCP servers. It runs both a client UI (default port 5173) and an MCP proxy server (default port 3000). Open the client UI in your browser to use the inspector.

QDRANT_URL=":memory:" COLLECTION_NAME="test" \
mcp dev src/mcp_server_qdrant/server.py

Once started, open your browser to http://localhost:5173 to access the inspector interface.

License

This MCP server is licensed under the Apache License 2.0. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the Apache License 2.0. For more details, please see the LICENSE file in the project repository.

5.1 KiB Raw Blame History Unescape Escape