Qdrant MCP Server
mcp-server-qdrant
Официальный MCP-сервер Qdrant: семантическая память агента на векторной базе, сохранение и поиск по смыслу
Установка
QDRANT_URL="http://localhost:6333" \
COLLECTION_NAME="my-collection" \
EMBEDDING_MODEL="sentence-transformers/all-MiniLM-L6-v2" \
uvx mcp-server-qdrantЗапуск по stdio, для удаленных клиентов добавьте --transport sse или streamable-http.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер превращает Qdrant в долговременную память агента с двумя инструментами. qdrant-store сохраняет текст с необязательными метаданными в коллекцию, qdrant-find ищет сохраненное по смыслу запроса. Эмбеддинги считаются локально моделями FastEmbed, по умолчанию all-MiniLM-L6-v2. Подключаться можно к серверу Qdrant по адресу или к локальной базе в папке. Описания инструментов настраиваются, поэтому сервер можно превратить, например, в хранилище фрагментов кода.
Для кого. Для разработчиков, которым нужна общая память агента между сеансами и клиентами на собственной векторной базе.
Подходит, если
- Агент должен помнить решения и факты между сеансами
- Нужен поиск по смыслу в накопленных заметках или фрагментах кода
- Qdrant уже используется в проекте
Не подходит, если
- Нужен только текстовый файл памяти вроде CLAUDE.md
- Нужны эмбеддинги от внешнего провайдера: поддерживается только FastEmbed
Пример запроса к агенту
Запомни, что в этом проекте даты храним в UTC, а потом найди в памяти все договоренности про формат данныхОграничения
Поддерживаются только модели FastEmbed. Нельзя одновременно задать QDRANT_URL и QDRANT_LOCAL_PATH. При первом запуске модель эмбеддингов скачивается из интернета. В локальном режиме и с собственным Qdrant внешние сервисы не нужны, Qdrant Cloud требует ключа.
Как отключить. Удалите блок qdrant из конфигурации MCP клиента. Сохраненные данные останутся в коллекции Qdrant или локальной папке, их удаляют отдельно.
MCP
- Транспорт
- stdio, sse, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| QDRANT_URL | Адрес сервера Qdrant, альтернатива QDRANT_LOCAL_PATH |
| QDRANT_API_KEY секрет | Ключ API сервера Qdrant |
| QDRANT_LOCAL_PATH | Путь к локальной базе Qdrant |
| COLLECTION_NAME | Коллекция по умолчанию |
| EMBEDDING_MODEL | Модель FastEmbed для эмбеддингов |
| QDRANT_READ_ONLY | true отключает запись |
Проверка безопасности
- Пишет данные в векторную базу
- Скачивает модель эмбеддингов при первом запуске
Коротко о README
README описывает два инструмента, все переменные окружения сервера и FastMCP, запуск через uvx, Docker и Smithery. Показаны транспорты stdio, SSE и Streamable HTTP, конфигурации для Claude Desktop с облачным и локальным Qdrant. Есть примеры настройки под Cursor, Windsurf и VS Code, в том числе как хранилища кода. Лицензия Apache 2.0.
Частые вопросы
Нужен ли запущенный Qdrant?
Нет, можно указать QDRANT_LOCAL_PATH, и база будет храниться в локальной папке.
Можно ли запретить агенту запись?
Да, QDRANT_READ_ONLY=true отключает инструмент qdrant-store.
Похожие
Открытый личный AI-ассистент на своем компьютере: отвечает в Telegram, Slack, Discord и WhatsApp, расширяется скиллами и плагинами
Самообучающийся агент от Nous Research: терминал, мессенджеры, cron-задачи и скиллы, которые он пишет сам
Открытый агент для программирования в терминале и на десктопе с режимами разработки и планирования
Агент Anthropic для терминала, IDE и GitHub: понимает кодовую базу, выполняет задачи и работает с git