mcp-server-qdrant

mcp-server-qdrant — официальный MCP-сервер от qdrant. Интеграция с векторной базой Qdrant для хранения и поиска информации. Ставится через uvx или через Docker. Лицензия Apache-2.0.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
qdrant
Лицензия
Apache-2.0
Транспорт
stdio, sse, streamable_http
Авторизация
api_key
ОС
Не указана
Языки
python

Уровень риска: high

Всё сохранённое попадает в коллекцию Qdrant (локально или в облаке); `QDRANT_API_KEY` даёт доступ к базе. Для поиска без записи включите `QDRANT_READ_ONLY=true`, не сохраняйте пароли и персональные данные.

Настройка клиентов

vscode
{
    "code": "{\n  \"mcp\": {\n    \"inputs\": [\n      {\n        \"type\": \"promptString\",\n        \"id\": \"qdrantUrl\",\n        \"description\": \"Qdrant URL\"\n      },\n      {\n        \"type\": \"promptString\",\n        \"id\": \"qdrantApiKey\",\n        \"description\": \"Qdrant API Key\",\n        \"password\": true\n      },\n      {\n        \"type\": \"promptString\",\n        \"id\": \"collectionName\",\n        \"description\": \"Collection Name\"\n      }\n    ],\n    \"servers\": {\n      \"qdrant\": {\n        \"command\": \"uvx\",\n        \"args\": [\n          \"mcp-server-qdrant\"\n        ],\n        \"env\": {\n          \"QDRANT_URL\": \"${input:qdrantUrl}\",\n          \"QDRANT_API_KEY\": \"${input:qdrantApiKey}\",\n          \"COLLECTION_NAME\": \"${input:collectionName}\"\n        }\n      }\n    }\n  }\n}",
    "file": "User Settings (JSON)",
    "lang": "json",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

mcp-server-qdrant — официальный MCP-сервер Qdrant. Он работает как слой семантической памяти поверх векторной базы Qdrant: ассистент сохраняет информацию и находит её по смыслу запроса, а не по точным словам. Эмбеддинги считаются локально через FastEmbed, по умолчанию моделью sentence-transformers/all-MiniLM-L6-v2.

Инструментов два:

  • qdrant-store сохраняет текст в коллекцию Qdrant, при желании с метаданными в JSON.
  • qdrant-find находит в коллекции записи, близкие к запросу, и возвращает их отдельными сообщениями.

Сервер подключается к Qdrant по адресу (QDRANT_URL, в том числе Qdrant Cloud с ключом) или к локальной базе в папке (QDRANT_LOCAL_PATH). Коллекция создаётся автоматически, если её нет. Описания инструментов можно переписать через переменные окружения: так сервер превращается, например, в хранилище фрагментов кода для поиска по смыслу. Поддерживаются транспорты stdio, SSE и Streamable HTTP.

Кому подойдёт

  • Тем, кто хочет дать ассистенту память: заметки, факты и решения сохраняются между сессиями и находятся по смыслу.
  • Разработчикам: README описывает режим поиска по коду для Cursor, Windsurf и Claude Code с хранением сниппетов.
  • Командам с Qdrant: один сервер с SSE можно подключить для всей команды или в облаке.

Другие варианты — в категориях базы данных и знания и память.

Установка

Сервер запускается через uvx без установки:

uvx mcp-server-qdrant

Настройка идёт через переменные окружения: QDRANT_URL или QDRANT_LOCAL_PATH (одновременно задавать нельзя), QDRANT_API_KEY, COLLECTION_NAME, EMBEDDING_MODEL. Транспорт выбирается единственным аргументом --transport. Есть установка через Smithery и Docker.

Подключение к клиентам

Команда и конфиги приведены дословно из README. Для Claude Desktop блок добавляется в раздел mcpServers файла claude_desktop_config.json. Общий порядок — в инструкции как подключить MCP.

claude_desktop_config.json
{
  "qdrant": {
    "command": "uvx",
    "args": ["mcp-server-qdrant"],
    "env": {
      "QDRANT_URL": "https://xyz-example.eu-central.aws.cloud.qdrant.io:6333",
      "QDRANT_API_KEY": "your_api_key",
      "COLLECTION_NAME": "your-collection-name",
      "EMBEDDING_MODEL": "sentence-transformers/all-MiniLM-L6-v2"
    }
  }
}

В README команда для Claude Code содержит ещё переменные TOOL_STORE_DESCRIPTION и TOOL_FIND_DESCRIPTION с описаниями для поиска по коду. Для Cursor и Windsurf README советует запустить сервер с транспортом SSE и указать адрес http://localhost:8000/sse.

Проверка

Попросите ассистента запомнить факт, например «наш стенд разработки — dev.example.local», а потом спросите, где стенд разработки. Он должен вызвать qdrant-store, затем qdrant-find.

Примеры задач

Запомни, что релизы мы выпускаем по вторникам, а хотфиксы — в любой день после ревью.
Найди в памяти всё, что мы решили про авторизацию пользователей.
Сохрани этот фрагмент кода с описанием, чтобы потом найти его по смыслу.

Риски

Всё, что ассистент сохраняет, попадает в коллекцию Qdrant — локально или в облаке, в зависимости от настроек. Ключ QDRANT_API_KEY даёт доступ к базе. В HTTP- и SSE-режимах сервер по умолчанию слушает 127.0.0.1:8000.

Как снизить риски: для поиска без записи включите QDRANT_READ_ONLY=true — это отключит qdrant-store. Не сохраняйте в память пароли и персональные данные, используйте отдельную коллекцию для каждого проекта, не открывайте порт сервера во внешнюю сеть без защиты. Лицензия — Apache-2.0.

Частые вопросы

Нужен ли сервер Qdrant?

Не обязательно. Можно указать QDRANT_LOCAL_PATH, и сервер будет работать с локальной базой в папке.

Какие эмбеддинги используются?

FastEmbed, по умолчанию модель sentence-transformers/all-MiniLM-L6-v2. Модель меняется переменной EMBEDDING_MODEL.

Можно ли запретить запись?

Да, переменная QDRANT_READ_ONLY=true отключает инструмент qdrant-store.

Основы протокола — на странице что такое MCP-сервер.

Инструменты

  • qdrant-find
  • qdrant-store

Похожие MCP-серверы

dbx

Запросы агентов к базам данных через подключения, настроенные в DBX.

Риск: medium Лицензия: Apache-2.0 ★ 29 956

XERJ

Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.

Риск: high Лицензия: Apache-2.0 ★ 18 558

MCP Toolbox for Databases

MCP Toolbox for Databases от Google подключает агента к вашим базам данных.

Риск: medium Лицензия: Apache-2.0 ★ 16 830

kubeshark

Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.

Риск: medium Лицензия: Apache-2.0 ★ 12 135

Источники