Qdrant Loader

v1.0.0Search & Data Extractionstable

Enterprise-ready vector database toolkit for building searchable knowledge bases from multiple data sources. Supports multi-project management, automatic ingestion from Confluence/JIRA/Git, intelligent file conversion (PDF/Office/images), and semanti

cli-toolconfluence-integrationcursor-idedeveloper-toolsdocument-processing
Share:
41
Stars
0
Downloads
0
Weekly
0/5

What is Qdrant Loader?

Qdrant Loader is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enterprise-ready vector database toolkit for building searchable knowledge bases from multiple data sources. supports multi-project management, automatic ingestion from confluence/jira/git, intelligen...

Enterprise-ready vector database toolkit for building searchable knowledge bases from multiple data sources. Supports multi-project management, automatic ingestion from Confluence/JIRA/Git, intelligent file conversion (PDF/Office/images), and semanti

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enterprise-ready vector database toolkit for building search

Use Cases

Build searchable knowledge bases from multiple data sources.
Automatically ingest from Confluence, JIRA, and Git.
Convert PDFs, Office documents, and images intelligently.
martin-papy

Maintainer

LicenseGPL-3.0
Languagepython
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx qdrant-loader

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Qdrant Loader

Qdrant Loader is an enterprise-ready toolkit that ingests data from multiple sources — Confluence, JIRA, Git repositories, local files, and public documentation sites — into a Qdrant vector database, and then exposes that knowledge base to AI assistants via an MCP server. It handles intelligent file conversion for PDFs, Office documents, images, and audio, performs hierarchical document chunking with change detection for incremental sync, and supports semantic search with cross-document relationship mapping. Development teams use it to give their AI coding assistant access to internal wikis, project documentation, and codebases through a single searchable knowledge base.

Prerequisites

  • Python 3.10 or later with pip available
  • A running Qdrant instance (local via Docker or Qdrant Cloud) with its URL accessible
  • An OpenAI API key (or compatible provider) for generating embeddings
  • Access credentials for the data sources you want to ingest (Confluence API token, JIRA token, Git credentials as needed)
  • An MCP-compatible client such as Claude Desktop or Cursor
1

Install qdrant-loader and the MCP server package

Install both the ingestion toolkit and the MCP server component with pip.

pip install qdrant-loader qdrant-loader-mcp-server
2

Start a local Qdrant instance (if not using Qdrant Cloud)

Run Qdrant locally using Docker on the default port 6333.

docker run -p 6333:6333 qdrant/qdrant
3

Set required environment variables

Export the Qdrant connection details and your OpenAI API key so the loader and MCP server can connect.

export QDRANT_URL=http://localhost:6333
export QDRANT_COLLECTION_NAME=my-knowledge-base
export OPENAI_API_KEY=sk-your-openai-api-key
export LLM_PROVIDER=openai
export LLM_EMBEDDING_MODEL=text-embedding-3-small
4

Ingest your data sources

Use the qdrant-loader CLI to ingest documents from your chosen sources into the Qdrant collection. Consult the documentation for connector-specific configuration.

qdrant-loader --config /path/to/config.yaml ingest
5

Configure your MCP client to use the server

Add the qdrant-loader MCP server to your claude_desktop_config.json with the required environment variables so Claude can query your knowledge base.

{
  "mcpServers": {
    "qdrant-loader": {
      "command": "qdrant-loader-mcp-server",
      "args": [],
      "env": {
        "QDRANT_URL": "http://localhost:6333",
        "QDRANT_COLLECTION_NAME": "my-knowledge-base",
        "OPENAI_API_KEY": "sk-your-openai-api-key",
        "LLM_PROVIDER": "openai",
        "LLM_EMBEDDING_MODEL": "text-embedding-3-small"
      }
    }
  }
}
6

Restart your MCP client and query

Quit and reopen Claude Desktop. The Qdrant Loader search tools will now be available, letting you query your ingested knowledge base in natural language.

Qdrant Loader Examples

Client configuration

claude_desktop_config.json entry for the Qdrant Loader MCP server with all required environment variables.

{
  "mcpServers": {
    "qdrant-loader": {
      "command": "qdrant-loader-mcp-server",
      "args": [],
      "env": {
        "QDRANT_URL": "http://localhost:6333",
        "QDRANT_COLLECTION_NAME": "my-knowledge-base",
        "OPENAI_API_KEY": "sk-your-openai-api-key",
        "LLM_PROVIDER": "openai",
        "LLM_EMBEDDING_MODEL": "text-embedding-3-small"
      }
    }
  }
}

Prompts to try

Example queries to run against your ingested knowledge base via the Qdrant Loader MCP server.

- "Find all documentation about our API authentication flow"
- "What does our Confluence runbook say about deploying to production?"
- "Search for code examples of database connection pooling in our Git repos"
- "Show me all JIRA tickets related to the payment service"
- "What are the deployment requirements mentioned in our architecture docs?"

Troubleshooting Qdrant Loader

Ingestion fails with connection refused errors

Verify that your Qdrant instance is running and accessible at the QDRANT_URL you set. For local Docker, check 'docker ps' to confirm the container is up and port 6333 is mapped correctly.

Embedding generation fails with authentication errors

Confirm OPENAI_API_KEY is set correctly and the key has not expired or hit quota limits. If using an alternative provider, ensure LLM_PROVIDER and LLM_BASE_URL are set to match your provider's API endpoint.

Search returns no results or irrelevant results after ingestion

Check that the QDRANT_COLLECTION_NAME in the MCP server config matches the collection used during ingestion. Run incremental sync again with 'qdrant-loader ingest' if sources have been updated since the last run.

Frequently Asked Questions about Qdrant Loader

What is Qdrant Loader?

Qdrant Loader is a Model Context Protocol (MCP) server that enterprise-ready vector database toolkit for building searchable knowledge bases from multiple data sources. supports multi-project management, automatic ingestion from confluence/jira/git, intelligent file conversion (pdf/office/images), and semanti It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Qdrant Loader?

Follow the installation instructions on the Qdrant Loader GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Qdrant Loader?

Qdrant Loader works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Qdrant Loader free to use?

Yes, Qdrant Loader is open source and available under the GPL-3.0 license. You can use it freely in both personal and commercial projects.

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "qdrant-loader": { "command": "npx", "args": ["-y", "qdrant-loader"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Qdrant Loader?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides