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`, не сохраняйте пароли и персональные данные.
Настройка клиентов
{
"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.
{
"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.
XERJ
Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.
MCP Toolbox for Databases
MCP Toolbox for Databases от Google подключает агента к вашим базам данных.
kubeshark
Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.