Демо MCP-подключения к YDB на примере заметок
Simple CLI Notes Application with YDB
Официальный пример YDB: docker compose поднимает базу YDB и MCP-сервер ydb-mcp, а Cursor через них выполняет SQL прямо из чата
- 0 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- MCP-сервер выполняет произвольные SQL-запросы, включая изменение схемы и данных YDB
- В демо-конфигурации доступ к MCP не защищен авторизацией
Установка
- Работает в
- Сервисы
Ручная установка
docker-compose up -d ydb ydb-mcpПервый запуск собирает образ ydb-mcp дольше, следующие запуски используют кеш.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- MCP-сервер выполняет произвольные SQL-запросы, включая изменение схемы и данных 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 и покажи, какие таблицы там естьMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
YDB_ENDPOINTобязательная- Адрес сервера YDB, например grpc://localhost:2136.
YDB_DATABASEобязательная- Путь к базе данных YDB, например /local.
Ограничения
Это демонстрационный проект вокруг официального пакета ydb-mcp, а не отдельный продукт: реальный MCP-сервер это pip-пакет ydb-mcp, а репозиторий лишь настраивает его в docker-compose с игрушечным приложением заметок. Нужен Docker и Docker Compose. Больше года без пушей и обновлений. README на английском языке.
Как отключить. Остановите контейнеры командой docker-compose down и уберите блок ydb из .cursor/mcp.json.
Частые вопросы
Что на самом деле выполняет SQL-запросы?
Официальный pip-пакет ydb-mcp, собранный в Dockerfile.ydb-mcp, а этот репозиторий лишь связывает его с локальной YDB и Cursor через docker-compose.
Нужен ли Python локально?
Нет, при использовании Docker Compose Python ставить не нужно, все сервисы работают в контейнерах.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
YDB — все инструментыОфициальный MCP-сервер YDB
YDB MCP
Официальный MCP-сервер YDB от разработчиков базы: SQL-запросы с параметрами, план выполнения, обзор директорий и основа для своих серверов
Тулкит для локальных развертываний YDB
local-ydb-toolkit
Скилл и MCP-сервер для управления Docker-развертываниями local-ydb: узлы, схема, дамп и восстановление, локально или по SSH
Официальный MCP-сервер долгой памяти для агентов на базе YDB Serverless: mem0 извлекает факты, YDB хранит векторы
Один бинарник MCP-сервера для MySQL, MariaDB, PostgreSQL и SQLite: запросы только на чтение по умолчанию и маскировка ПДн
Терминальный клиент баз данных на Rust с MCP и JSON CLI: агент читает схему и запускает запросы с правами профиля.
Один MCP-сервер для SQLite, SQL Server, PostgreSQL и MySQL: агент читает и меняет данные, правит схему и выгружает CSV и JSON
Коротко о README
Основной README на английском описывает CLI-приложение заметок на YDB и запуск через Docker Compose. Отдельный README-MCP.md и QUICKSTART-MCP.md на русском и английском объясняют конфигурацию MCP-сервиса ydb-mcp с host-сетью, переменные YDB_ENDPOINT и YDB_DATABASE и подключение в Cursor через .cursor/mcp.json.