Официальный MCP-сервер YDB
YDB MCP
Официальный MCP-сервер YDB от разработчиков базы: SQL-запросы с параметрами, план выполнения, обзор директорий и основа для своих серверов
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Базовый сервер выполняет произвольный SQL, включая изменение и удаление данных
- Аутентификация токеном или сервисным аккаунтом дает широкий доступ к базе, если не ограничить права ключа
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/ydb-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio ydb -- uvx ydb-mcp --ydb-endpoint grpc://localhost:2136 --ydb-database /localИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"ydb": {
"command": "uvx",
"args": [
"ydb-mcp",
"--ydb-endpoint",
"grpc://localhost:2136",
"--ydb-database",
"/local"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"ydb": {
"command": "uvx",
"args": [
"ydb-mcp",
"--ydb-endpoint",
"grpc://localhost:2136",
"--ydb-database",
"/local"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Выполните в терминале
code --add-mcp '{"name":"ydb","type":"stdio","command":"uvx","args":["ydb-mcp","--ydb-endpoint","grpc://localhost:2136","--ydb-database","/local"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"ydb": {
"type": "stdio",
"command": "uvx",
"args": [
"ydb-mcp",
"--ydb-endpoint",
"grpc://localhost:2136",
"--ydb-database",
"/local"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Выполните в терминале
codex mcp add ydb -- uvx ydb-mcp --ydb-endpoint grpc://localhost:2136 --ydb-database /localИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.ydb]
command = "uvx"
args = ["ydb-mcp", "--ydb-endpoint", "grpc://localhost:2136", "--ydb-database", "/local"]Если файл уже есть, допишите блок в конец.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"ydb": {
"command": "uvx",
"args": [
"ydb-mcp",
"--ydb-endpoint",
"grpc://localhost:2136",
"--ydb-database",
"/local"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"ydb": {
"command": "uvx",
"args": [
"ydb-mcp",
"--ydb-endpoint",
"grpc://localhost:2136",
"--ydb-database",
"/local"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"ydb": {
"command": "uvx",
"args": [
"ydb-mcp",
"--ydb-endpoint",
"grpc://localhost:2136",
"--ydb-database",
"/local"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"ydb": {
"command": "uvx",
"args": [
"ydb-mcp",
"--ydb-endpoint",
"grpc://localhost:2136",
"--ydb-database",
"/local"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"ydb": {
"type": "local",
"command": [
"uvx",
"ydb-mcp",
"--ydb-endpoint",
"grpc://localhost:2136",
"--ydb-database",
"/local"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"ydb": {
"command": "uvx",
"args": [
"ydb-mcp",
"--ydb-endpoint",
"grpc://localhost:2136",
"--ydb-database",
"/local"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"ydb": {
"command": "uvx",
"args": [
"ydb-mcp",
"--ydb-endpoint",
"grpc://localhost:2136",
"--ydb-database",
"/local"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавь сервер в конфигурацию MCP клиента с command uvx и args ydb-mcp --ydb-endpoint grpc://localhost:2136 --ydb-database /local, для боевой базы добавь --ydb-auth-mode с логином и паролем, токеном доступа или сервисным аккаунтом Yandex Cloud.
Другие способы из описания автора
{
"mcpServers": {
"ydb": {
"command": "uvx",
"args": [
"ydb-mcp",
"--ydb-endpoint", "grpc://localhost:2136",
"--ydb-database", "/local"
]
}
}
}Запуск через uvx без установки пакета в систему, пример с анонимной аутентификацией.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту семь инструментов для распределенной базы данных YDB: выполнение SQL-запроса, выполнение параметризованного запроса с JSON-параметрами, получение плана выполнения для обычного и параметризованного запроса, просмотр содержимого директории, подробное описание пути (таблицы, директории) и статус соединения с базой. Поддерживаются анонимная аутентификация, логин и пароль, токен доступа и аутентификация через сервисный аккаунт Yandex Cloud с пакетом yandexcloud. Класс YDBMCPServer рассчитан на наследование: можно добавить свои инструменты поверх готового соединения и отключить общие инструменты, чтобы модель видела только нужный для бизнес-логики набор SQL-запросов вместо произвольного доступа к базе.
Для кого. Для разработчиков и дата-инженеров, которые работают с YDB и хотят выполнять запросы и смотреть схему базы через агента.
Подходит, если
- Нужен официальный, поддерживаемый разработчиками YDB MCP-сервер, а не сторонняя обертка
- Нужен план выполнения запроса перед тем, как гонять его на боевой базе
- Нужно ограничить агента фиксированным набором безопасных запросов через свой подкласс сервера
Не подходит, если
- Нужна защита от произвольного SQL из коробки: базовый сервер выполняет любой присланный запрос без ограничений
- Работаете не с YDB, а с другой базой данных
Пример запроса к агенту
Покажи план выполнения этого запроса к YDB и список таблиц в директории /local/ordersОграничения
Базовый сервер выполняет произвольные SQL-запросы к базе, включая изменяющие данные, если явно не сузить набор инструментов через наследование. Аутентификация через сервисный аккаунт Yandex Cloud требует дополнительный пакет yandexcloud. Для работы нужен доступный по grpc endpoint YDB, локальный или облачный.
Как отключить. Удалите блок ydb из конфигурации MCP клиента.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Проверка безопасности
- Базовый сервер выполняет произвольный SQL, включая изменение и удаление данных
- Аутентификация токеном или сервисным аккаунтом дает широкий доступ к базе, если не ограничить права ключа
Коротко о README
README описывает YDB MCP как официальный сервер для работы с базами YDB из любого LLM, поддерживающего MCP. Показаны три способа установки и запуска (uvx, pipx, pip), примеры конфигурации для анонимного доступа, логина и пароля, токена доступа и сервисного аккаунта Yandex Cloud, список из семи инструментов и отдельный раздел про создание своих MCP-серверов на основе класса YDBMCPServer с отключением общих инструментов ради безопасности и специфики домена.
Частые вопросы
Можно ли ограничить агента только чтением?
Да, для этого нужно унаследоваться от YDBMCPServer, отключить общие инструменты и добавить свои с ограниченным набором запросов.
Какие способы аутентификации поддержаны?
Анонимный доступ, логин и пароль, токен доступа и сервисный аккаунт Yandex Cloud.
Похожие
166 скиллов для научных задач: биоинформатика, хемоинформатика, клинические данные, геоданные и доступ к 100+ базам
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
Официальные скиллы Hugging Face: работа с Hub через CLI hf, датасеты, обучение моделей, Spaces, оценка и деплой
Язык визуализации для агентов и MCP-сервер: из простой семантической спецификации собираются аккуратные графики