Демо MCP-подключения к YDB на примере заметок
Simple CLI Notes Application with YDB
Официальный пример YDB: docker compose поднимает базу YDB и MCP-сервер ydb-mcp, а Cursor через них выполняет SQL прямо из чата
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- MCP-сервер выполняет произвольные SQL-запросы, включая изменение схемы и данных YDB
- В демо-конфигурации доступ к MCP не защищен авторизацией
Установка
Ручная установка
docker-compose up -d ydb ydb-mcpПервый запуск собирает образ ydb-mcp дольше, следующие запуски используют кеш.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект показывает, как подключить агента к базе данных YDB через MCP. Docker Compose поднимает три сервиса: локальный сервер YDB, MCP-сервер ydb-mcp, собранный из официального pip-пакета, и простое CLI-приложение заметок на Python как пример своей базы. Готовый файл .cursor/mcp.json запускает ydb-mcp командой docker compose run и дает Cursor выполнять SQL-запросы, смотреть и менять схему и данные YDB прямо из диалога. Само приложение заметок нужно лишь для наглядности: создание, список, просмотр и удаление заметок через YDB.
Для кого. Для разработчиков, которые хотят быстро попробовать MCP-доступ к YDB из Cursor на локальной базе.
Подходит, если
- Нужен быстрый локальный стенд YDB с MCP-доступом для Cursor
- Нужен пример docker-compose конфигурации, которая связывает YDB и ydb-mcp
- Нужно на игрушечном примере понять, как агент видит схему и данные YDB
Не подходит, если
- Нужно подключить MCP к уже существующей боевой базе YDB: конфигурация здесь рассчитана на локальный контейнер
- Нужен готовый npm или системный пакет заметок: это учебный пример, а не продукт
Пример запроса к агенту
Подключись к моей локальной базе YDB и покажи, какие таблицы там естьОграничения
Это демонстрационный проект вокруг официального пакета ydb-mcp, а не отдельный продукт: реальный MCP-сервер это pip-пакет ydb-mcp, а репозиторий лишь настраивает его в docker-compose с игрушечным приложением заметок. Нужен Docker и Docker Compose. Больше года без пушей и обновлений. README на английском языке.
Как отключить. Остановите контейнеры командой docker-compose down и уберите блок ydb из .cursor/mcp.json.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| YDB_ENDPOINT обязательная | Адрес сервера YDB, например grpc://localhost:2136. |
| YDB_DATABASE обязательная | Путь к базе данных YDB, например /local. |
Проверка безопасности
- MCP-сервер выполняет произвольные SQL-запросы, включая изменение схемы и данных YDB
- В демо-конфигурации доступ к MCP не защищен авторизацией
Коротко о README
Основной README на английском описывает CLI-приложение заметок на YDB и запуск через Docker Compose. Отдельный README-MCP.md и QUICKSTART-MCP.md на русском и английском объясняют конфигурацию MCP-сервиса ydb-mcp с host-сетью, переменные YDB_ENDPOINT и YDB_DATABASE и подключение в Cursor через .cursor/mcp.json.
Частые вопросы
Что на самом деле выполняет SQL-запросы?
Официальный pip-пакет ydb-mcp, собранный в Dockerfile.ydb-mcp, а этот репозиторий лишь связывает его с локальной YDB и Cursor через docker-compose.
Нужен ли Python локально?
Нет, при использовании Docker Compose Python ставить не нужно, все сервисы работают в контейнерах.
Похожие
166 скиллов для научных задач: биоинформатика, хемоинформатика, клинические данные, геоданные и доступ к 100+ базам
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
Официальные скиллы Hugging Face: работа с Hub через CLI hf, датасеты, обучение моделей, Spaces, оценка и деплой
Язык визуализации для агентов и MCP-сервер: из простой семантической спецификации собираются аккуратные графики