Задачи, которые агент решает в YDB
- Отвечает на вопросы по данным. Официальный MCP-сервер YDB с 7 инструментами выполняет SQL и параметризованные запросы с JSON-параметрами.
- Разбирает медленные запросы. Тот же сервер возвращает план выполнения для обычного и параметризованного запроса.
- Изучает схему. Инструменты просмотра директории и описания пути показывают таблицы и папки базы.
- Поднимает базу для разработки и CI. Тулкит local-ydb запускает root и тенантные базы в Docker, управляет динамическими узлами, применяет DDL, делает дамп и восстановление, локально или по SSH.
- Помнит контекст между сессиями. mcp-memory-ydb складывает факты в YDB Serverless как векторы и ищет их семантически.
- Показывает связку за один вечер. Демо с заметками поднимает 3 сервиса через docker compose: базу, сервер и приложение заметок. Файл .cursor/mcp.json уже готов.
Как подключить YDB к агенту
Официальный сервер ставится из PyPI и запускается через uvx. Ему нужны адрес базы по gRPC, например grpc://localhost:2136, и путь к базе. Из каталога официальный сервер ставит npx skillfoxx add mcp/ydb-mcp, а тулкит npx skillfoxx add plugins/local-ydb-toolkit. Тулкиту нужен Node.js 20.19 или новее.
Анонимный вход YDB разрешает по умолчанию, но документация советует его только для локальных учебных баз. Для остальных случаев способ входа задает параметр --ydb-auth-mode с 3 значениями.
- login-password для встроенных пользователей YDB. Токен после входа действует 12 часов.
- access-token для фиксированного токена. Документация YDB оставляет этот способ для тестов и отладки.
- service-account для ключа сервисного аккаунта Yandex Cloud в JSON-файле. Для него нужен пакет yandexcloud.
Официальный сервер, тулкит или память
У официального сервера широкий уровень доступа, потому что он умеет выполнять произвольный SQL. Тулкит, сервер памяти и демо получили расширенный. Local-ydb работает только с выбранным локальным профилем и перед изменениями показывает план, а сервер памяти вместо SQL дает 4 инструмента памяти.
Официальный сервер, сервер памяти и демо опубликованы в организации ydb-platform на GitHub, а local-ydb написан сообществом. Без VPN работают все инструменты, кроме сервера памяти, для которого это не проверено. Серверы для других баз Foxx AI подберет по описанию проекта.
Для своей бизнес-логики разработчики YDB предлагают наследоваться от класса YDBMCPServer. Добавьте свои инструменты и выключите общие. Тогда модель увидит только заданный набор запросов.
Ограничения и безопасность
По README официального сервера запросы по умолчанию идут в режиме только для чтения. Запись включает флаг --ydb-allow-write или переменная YDB_ALLOW_WRITE=true. Вторым барьером служит пользователь YDB с правами только на чтение, которого советуют сами разработчики.
У mcp-memory-ydb пространство имен не разграничивает доступ: любой, у кого есть доступ к базе, прочитает чужую память. Текст для извлечения фактов уходит провайдеру модели, OpenAI, YandexGPT или локальной Ollama. mem0 версии 2.x только добавляет факты, а устаревшие приходится удалять вручную. По умолчанию факты сохраняются на английском, для русского задайте MEMORY_FACT_INSTRUCTIONS.
В демо-конфигурации доступ к MCP не закрыт авторизацией, поэтому держите ее только на своей машине.