Qdrant MCP Server

РЕДАКЦИОННЫЙ РАЗБОР

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

Агент должен возвращаться к ранее сохранённым сведениям: например, к коротким заметкам проекта. В официальном примере Qdrant сервер подключается к Google ADK и даёт хранение с семантическим поиском. Запрос можно сформулировать иначе, чем исходную заметку.

РЕДАКЦИОННЫЙ РАЗБОР

Начать с маленькой памяти

Для первого опыта подготовьте несколько различающихся фактов и отдельную тестовую коллекцию. Один запрос должен находить нужную запись, другой — не иметь подходящего ответа. Такая пара помогает заметить, когда ассистент превращает похожий текст в уверенное, но неверное заключение.

РЕДАКЦИОННЫЙ РАЗБОР

Определить происхождение записей

Заранее решите, какие сведения разрешено сохранять, кто отвечает за их актуальность и как возвращаться к исходному документу. Само подключение MCP не организует загрузку всей базы знаний и не поддерживает её содержание в актуальном состоянии.

ПОДКЛЮЧЕНИЕ

Подключение к существующему агенту Google ADK

1. Подготовить Qdrant

   Для локального примера нужен уже запущенный экземпляр Qdrant с адресом http://localhost:6333. Выберите отдельное имя тестовой коллекции и способ хранения данных. Первичная настройка базы описана в Qdrant Quickstart.

2. Подготовить ADK и uvx

   Используйте Python-окружение с Google ADK и доступной командой uvx. У агента должна быть настроена его модель и необходимые для неё учётные данные. Официальный пример устанавливает ADK командой pip install google-adk.

3. Добавить MCP toolset

   В tools агента добавьте McpToolset со StdioConnectionParams и StdioServerParameters. Параметры запуска из авторского примера: command — uvx, args — ["mcp-server-qdrant"], env — QDRANT_URL с адресом базы и COLLECTION_NAME с именем вашей коллекции; timeout — 30 секунд.

4. Проверить сохранение и поиск

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

Редакционный пробный сценарий: после сохранения факта повторите поиск в новом диалоге того же агента и той же коллекции. Проверьте также вопрос, ответа на который в коллекции нет. Сервер, база и модель при подготовке профиля не запускались.

ГРАНИЦЫ

Что учесть

• Семантическая близость не равна подтверждению факта. Возвращённую запись нужно сопоставить с вопросом и её источником.
• Этот профиль описывает проверенный по официальной статье путь через ADK. Полная матрица параметров MCP-сервера и совместимость остальных клиентов здесь не проверены.
• Qdrant и MCP-процесс — отдельные части подключения; запуск одного MCP-процесса не заменяет подготовку базы.

ДОСТУП

Права и условия

• Для локального экземпляра Qdrant не требуется аккаунт Qdrant Cloud. Нужен доступ к самой базе; облачный вариант имеет отдельную настройку доступа.
• ADK-агенту нужны учётные данные выбранной модели, если она их требует. Тестовая база должна оставаться в предназначенном для неё окружении.

ПЕРВОИСТОЧНИКИ

На чём основан разбор

• Qdrant — подключение MCP к Google ADK — откроется в новой вкладкеСверено: 2026-10-14
• Qdrant — локальный экземпляр и хранение — откроется в новой вкладкеСверено: 2026-10-14