Qdrant MCP: семантическая память и поиск по коду для агента

qdrant/mcp-server-qdrant· Проверено 12.11.2026· 1,6 тыс.на GitHub

Делает Qdrant семантической памятью агента: сохранить заметку или фрагмент кода с метаданными и найти его потом запросом на обычном языке. Вариант mhalder ещё индексирует кодовую базу и историю git.

2 реализации:

Два инструмента, store и find: сам создаёт коллекцию и считает эмбеддинги через FastEmbed, работает с сервером Qdrant, Qdrant Cloud или локальной папкой.

Как подключить

Что сделать до подключения

Менеджер пакетов uv с командой uvx

Сервер Qdrant или кластер Qdrant Cloud; для работы без сервера вместо QDRANT_URL задайте QDRANT_LOCAL_PATH с папкой базы

QDRANT_API_KEY

Ключ API кластера Qdrant Cloud или своего Qdrant с включённой авторизацией; для локального Qdrant без ключа не нужен

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'QDRANT_URL=<адрес Qdrant, например http://localhost:6333>' --env 'QDRANT_API_KEY=<ключ Qdrant, если нужен>' --env 'COLLECTION_NAME=<имя коллекции>' --transport stdio qdrant \
  -- uvx mcp-server-qdrant

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.qdrant]
command = "uvx"
args = ["mcp-server-qdrant"]

[mcp_servers.qdrant.env]
QDRANT_URL = "<адрес Qdrant, например http://localhost:6333>"
QDRANT_API_KEY = "<ключ Qdrant, если нужен>"
COLLECTION_NAME = "<имя коллекции>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "qdrant": {
      "command": "uvx",
      "args": ["mcp-server-qdrant"],
      "env": {
        "QDRANT_URL": "<адрес Qdrant, например http://localhost:6333>",
        "QDRANT_API_KEY": "<ключ Qdrant, если нужен>",
        "COLLECTION_NAME": "<имя коллекции>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "qdrant": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-server-qdrant"],
      "env": {
        "QDRANT_URL": "<адрес Qdrant, например http://localhost:6333>",
        "QDRANT_API_KEY": "<ключ Qdrant, если нужен>",
        "COLLECTION_NAME": "<имя коллекции>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "qdrant": {
      "command": "uvx",
      "args": ["mcp-server-qdrant"],
      "env": {
        "QDRANT_URL": "<адрес Qdrant, например http://localhost:6333>",
        "QDRANT_API_KEY": "<ключ Qdrant, если нужен>",
        "COLLECTION_NAME": "<имя коллекции>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "qdrant": {
      "command": "uvx",
      "args": ["mcp-server-qdrant"],
      "env": {
        "QDRANT_URL": "<адрес Qdrant, например http://localhost:6333>",
        "QDRANT_API_KEY": "<ключ Qdrant, если нужен>",
        "COLLECTION_NAME": "<имя коллекции>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "qdrant": {
        "type": "local",
        "command": ["uvx", "mcp-server-qdrant"],
        "environment": {
          "QDRANT_URL": "<адрес Qdrant, например http://localhost:6333>",
          "QDRANT_API_KEY": "<ключ Qdrant, если нужен>",
          "COLLECTION_NAME": "<имя коллекции>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "qdrant": {
      "command": "uvx",
      "args": ["mcp-server-qdrant"],
      "env": {
        "QDRANT_URL": "<адрес Qdrant, например http://localhost:6333>",
        "QDRANT_API_KEY": "<ключ Qdrant, если нужен>",
        "COLLECTION_NAME": "<имя коллекции>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "qdrant": {
      "command": "uvx",
      "args": ["mcp-server-qdrant"],
      "env": {
        "QDRANT_URL": "<адрес Qdrant, например http://localhost:6333>",
        "QDRANT_API_KEY": "<ключ Qdrant, если нужен>",
        "COLLECTION_NAME": "<имя коллекции>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

qdrant-storeсохраняет текст с метаданными

qdrant-findищет похожее по смыслу

Полный набор: коллекции, документы, гибридный поиск, индексация кода и истории git; эмбеддинги по умолчанию через локальную Ollama.

Как подключить

Что сделать до подключения

Node.js 22.x или 24.x и Podman или Docker с Compose

Склонировать репозиторий, выполнить npm install и поднять Qdrant с Ollama командой docker compose up -d

Скачать модель эмбеддингов: docker exec ollama ollama pull nomic-embed-text

Собрать сервер командой npm run build

QDRANT_API_KEY

Нужен только для Qdrant Cloud или Qdrant с авторизацией

OPENAI_API_KEY

Только если вместо Ollama выбран EMBEDDING_PROVIDER=openai; так же подключаются cohere и voyage

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio qdrant-mcp-server \
  -- node /path/to/qdrant-mcp-server/build/index.js

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.qdrant-mcp-server]
command = "node"
args = ["/path/to/qdrant-mcp-server/build/index.js"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "qdrant-mcp-server": {
      "command": "node",
      "args": ["/path/to/qdrant-mcp-server/build/index.js"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "qdrant-mcp-server": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/qdrant-mcp-server/build/index.js"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "qdrant-mcp-server": {
      "command": "node",
      "args": ["/path/to/qdrant-mcp-server/build/index.js"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "qdrant-mcp-server": {
      "command": "node",
      "args": ["/path/to/qdrant-mcp-server/build/index.js"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "qdrant-mcp-server": {
        "type": "local",
        "command": ["node", "/path/to/qdrant-mcp-server/build/index.js"]
      }
    }
  }
}

{
  "mcpServers": {
    "qdrant-mcp-server": {
      "command": "node",
      "args": ["/path/to/qdrant-mcp-server/build/index.js"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "qdrant-mcp-server": {
      "command": "node",
      "args": ["/path/to/qdrant-mcp-server/build/index.js"]
    }
  }
}

Инструменты сервера

create_collectionсоздаёт коллекцию

list_collectionsперечисляет коллекции

add_documentsдобавляет документы

semantic_searchищет по смыслу

hybrid_searchищет по смыслу и словам

delete_documentsудаляет документы

index_codebaseиндексирует кодовую базу

search_codeищет по коду

reindex_changesпереиндексирует изменённые файлы

index_git_historyиндексирует историю git

search_git_historyищет по коммитам

contextual_searchищет по коду и коммитам

federated_searchищет по нескольким репозиториям

Что попросить агента

«Запомни: <факт о проекте>»Агент вызовет qdrant-store и сохранит текст в коллекцию

«Что я сохранял про <тема>?»Агент вызовет qdrant-find и вернёт найденные записи

«Создай коллекцию notes и добавь документ про машинное обучение»Сервер mhalder: агент вызовет create_collection и add_documents

«Проиндексируй <путь к репозиторию> и найди, где обрабатывается авторизация»Агент вызовет index_codebase, затем search_code

«Найди в истории git, как раньше чинили ошибку <описание>»Агент вызовет index_git_history и search_git_history

Для каких задач

Запомнить факты из разговора и найти их в следующей сессии

Собрать базу фрагментов кода и искать их описанием задачи

Проиндексировать репозиторий и искать по коду и коммитам на обычном языке

Найти, как раньше чинили похожую ошибку, по истории git

Создать коллекцию под RAG и загрузить в неё документы

Ограничения

В mcp-server-qdrant всего два инструмента, сохранить и найти, а модели эмбеддингов поддерживаются только из FastEmbed

QDRANT_URL и QDRANT_LOCAL_PATH нельзя задать одновременно

У сервера mhalder 36 звёзд и последнее обновление в июне 2026; запускается только из собранного клона

Режим HTTP у mhalder без своей защиты: в работе ставьте его за обратный прокси с HTTPS и авторизацией

Если не работает

Сервер установлен, но Cursor не пользуется инструментами Qdrant

Создайте правила Cursor, чтобы MCP-инструменты вызывались при каждом новом фрагменте кода; правила можно ограничить типами файлов.

Сервер mhalder пишет, что Qdrant или Ollama не запущены

Поднимите сервисы командой docker compose up -d или podman compose up -d; Ollama проверяется запросом curl http://localhost:11434.

Сервер mhalder не находит модель эмбеддингов

Скачайте её: docker exec ollama ollama pull nomic-embed-text.

search_code ничего не находит

Сначала проиндексируйте кодовую базу инструментом index_codebase.

Сервер mhalder не ставится на Node 24 с ошибкой tree-sitter

Node 24 требует C++20 для нативных модулей: выполните CXXFLAGS='-std=c++20' npm install.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
mcp-server-qdrantразработчик сервиса	Qdrant	1,6 тыс.	локально	токен	2	10 ноября 2026
Qdrant MCP Server	mhalder	36	локально	не нужен	13	14 июня 2026

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

Нужен ли Qdrant Cloud?

Нет. mcp-server-qdrant работает с любым сервером Qdrant по QDRANT_URL, например http://localhost:6333, или вообще без сервера с базой в локальной папке через QDRANT_LOCAL_PATH.

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

mcp-server-qdrant по умолчанию берёт sentence-transformers/all-MiniLM-L6-v2, сменить можно переменной EMBEDDING_MODEL, но только на модель FastEmbed. Сервер mhalder по умолчанию считает эмбеддинги в Ollama моделью nomic-embed-text.

Как сделать из Qdrant поиск по коду для Cursor?

Перепишите описания инструментов через TOOL_STORE_DESCRIPTION и TOOL_FIND_DESCRIPTION: описание кода кладётся в information, сам код — в metadata.code. Запустите сервер с --transport sse и подключите в Cursor адрес http://localhost:8000/sse.

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

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

Как подключить Qdrant MCP к Claude Code?

Выполните claude mcp add с переменными окружения: claude mcp add code-search -e QDRANT_URL="http://localhost:6333" -e COLLECTION_NAME="code-repository" -- uvx mcp-server-qdrant. Проверьте командой claude mcp list.

Можно ли запустить Qdrant MCP в Docker?

Да, у mcp-server-qdrant есть Dockerfile: соберите образ docker build -t mcp-server-qdrant . и запустите с -p 8000:8000 и FASTMCP_HOST="0.0.0.0", чтобы сервер слушал все интерфейсы контейнера.

Работает ли сервер из России?

Сервер и Qdrant можно держать на своём компьютере, тогда аккаунты не нужны; Qdrant Cloud и платные провайдеры эмбеддингов требуют своих аккаунтов.

Qdrant MCP: семантическая память и поиск по коду для агента

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

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

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