Для чего этот сервер?

YDB MCP-сервер подключает базы данных YDB к языковым моделям через протокол MCP. Он даёт возможность выполнять SQL-запросы, получать планы выполнения и просматривать схему таблиц прямо из ИИ-ассистента. Разработчики могут расширять его своими инструментами или ограничивать набор команд, чтобы обезопасить работу с базой. Вместо написания отдельного бэкенда — готовый мост между LLM и YDB.

Что он умеет?

Выполняет SQL-запросы к базам YDB, в том числе параметризованные с JSON-параметрами. Объясняет план выполнения обычных и параметризованных запросов - видно, как база их отработает. Показывает содержимое каталогов, описывает пути: таблицы, директории и другие объекты. Проверяет статус подключения. Ещё сервер можно расширить через наследование, добавив свои инструменты поверх готового подключения к YDB.

Каталог MCP
ydb/ydb-mcp

ydb/ydb-mcp

от ydb-platform

MCP-сервер для YDB: LLM выполняют SQL-запросы, анализируют планы и управляют объектами БД через естественный язык. Поддерживает аутентификацию и кастомные инструменты. Полезен разработчикам, работа...

Github PyPi Сайт сервера

README

7 инструментов

Версии

Установить сервер

YDB MCP

Model Context Protocol server for YDB. It allows to work with YDB databases from any LLM that supports MCP. This integration enables AI-powered database operations and natural language interactions with your YDB instances.

Usage

Via uvx

uvx, which is an allias for uv run tool, allows you to run various python applications without explicitly installing them. Below are examples of how to configure YDB MCP using uvx.

Example: Using Anonymous Authentication

{
  "mcpServers": {
    "ydb": {
      "command": "uvx",
      "args": [
        "ydb-mcp",
        "--ydb-endpoint", "grpc://localhost:2136",
        "--ydb-database", "/local"
      ]
    }
  }
}

Via pipx

pipx allows you to run various applications from PyPI without explicitly installing each one. However, it must be installed first. Below are examples of how to configure YDB MCP using pipx.

Example: Using Anonymous Authentication

{
  "mcpServers": {
    "ydb": {
      "command": "pipx",
      "args": [
        "run", "ydb-mcp",
        "--ydb-endpoint", "grpc://localhost:2136",
        "--ydb-database", "/local"
      ]
    }
  }
}

Часто задаваемые вопросы

Инструменты были проиндексированы: 15.10.2026

ydb_describe_path

Получает подробную информацию о пути YDB.

Параметры

pathstringобязательный

ydb_explain_query

Объясняет SQL-запрос для YDB.

Параметры

sqlstringобязательный

ydb_explain_query_with_params

Объясняет параметризованный SQL-запрос к YDB.

Параметры

paramsstring | objectобязательный
sqlstringобязательный

ydb_list_directory

Перечисляет содержимое каталога в YDB

Параметры

pathstringобязательный

ydb_query

Выполняет SQL-запрос только для чтения к базе данных YDB.

Параметры

sqlstringобязательный

ydb_query_with_params

Выполняет параметризованный SQL-запрос только для чтения с JSON-параметрами.

Параметры

paramsstring | objectобязательный
sqlstringобязательный

ydb_status

Получает текущий статус подключения YDB

Параметры

Без параметров.

`0.3.0`основная	21.09.2026
`0.2.2`	01.09.2026
`0.2.1`	27.03.2026
`0.2.0`	26.03.2026
`0.1.7`	24.03.2026
`0.1.6`	29.08.2025
`0.1.5`	12.08.2025
`0.1.4`	29.07.2025
`0.1.3`	29.07.2025
`0.1.2`	29.07.2025
`0.1.1`	25.04.2025
`0.1.0`	25.04.2025

Выберите клиент, чтобы установить ydb/ydb-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "ydb-ydb-mcp-3fg99av7sa": {
      "command": "uvx",
      "args": [
        "ydb-mcp",
        "--ydb-endpoint",
        "grpc://localhost:2136",
        "--ydb-database",
        "/local"
      ]
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "ydb-ydb-mcp-3fg99av7sa": {
      "command": "uvx",
      "args": [
        "ydb-mcp",
        "--ydb-endpoint",
        "grpc://localhost:2136",
        "--ydb-database",
        "/local"
      ]
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "ydb-ydb-mcp-3fg99av7sa": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ydb-mcp",
        "--ydb-endpoint",
        "grpc://localhost:2136",
        "--ydb-database",
        "/local"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"ydb-ydb-mcp-3fg99av7sa\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"ydb-mcp\",\"--ydb-endpoint\",\"grpc://localhost:2136\",\"--ydb-database\",\"/local\"]}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "ydb-ydb-mcp-3fg99av7sa": {
      "command": "uvx",
      "args": [
        "ydb-mcp",
        "--ydb-endpoint",
        "grpc://localhost:2136",
        "--ydb-database",
        "/local"
      ]
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add ydb-ydb-mcp-3fg99av7sa -- uvx ydb-mcp --ydb-endpoint grpc://localhost:2136 --ydb-database /local

Либо через JSON-конфиг:

claude mcp add-json ydb-ydb-mcp-3fg99av7sa "{\"command\":\"uvx\",\"args\":[\"ydb-mcp\",\"--ydb-endpoint\",\"grpc://localhost:2136\",\"--ydb-database\",\"/local\"]}"

Codex

Добавьте сервер командой в терминале:

codex mcp add ydb-ydb-mcp-3fg99av7sa -- uvx ydb-mcp --ydb-endpoint grpc://localhost:2136 --ydb-database /local

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.ydb-ydb-mcp-3fg99av7sa]
command = "uvx"
args = ["ydb-mcp", "--ydb-endpoint", "grpc://localhost:2136", "--ydb-database", "/local"]

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите ydb/ydb-mcp, а в поле команды запуска — строку ниже:

uvx ydb-mcp --ydb-endpoint grpc://localhost:2136 --ydb-database /local

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "ydb-ydb-mcp-3fg99av7sa": {
      "command": "uvx",
      "args": [
        "ydb-mcp",
        "--ydb-endpoint",
        "grpc://localhost:2136",
        "--ydb-database",
        "/local"
      ]
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "ydb-ydb-mcp-3fg99av7sa": {
      "command": "uvx",
      "args": [
        "ydb-mcp",
        "--ydb-endpoint",
        "grpc://localhost:2136",
        "--ydb-database",
        "/local"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например ydb-ydb-mcp-3fg99av7sa.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: ydb-ydb-mcp-3fg99av7sa
    command: uvx
    args:
      - "ydb-mcp"
      - "--ydb-endpoint"
      - "grpc://localhost:2136"
      - "--ydb-database"
      - "/local"

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "ydb-ydb-mcp-3fg99av7sa": {
      "command": "uvx",
      "args": [
        "ydb-mcp",
        "--ydb-endpoint",
        "grpc://localhost:2136",
        "--ydb-database",
        "/local"
      ]
    }
  }
}

Конфиг для установки сервера

{
  "command": "uvx",
  "args": [
    "ydb-mcp",
    "--ydb-endpoint",
    "grpc://localhost:2136",
    "--ydb-database",
    "/local"
  ]
}

Нужен uvx

Сервер запускается через uvx
Без него ничего работать не будет.

Как установить uvx

Информация о сервере

Номер в рейтинге: #185
Звезд на Github: 29
Форков на Github: 8
Загрузок: 1 448
Язык реализации: Python
Лицензия: Apache-2.0
Официальный сервер: Да
Дата обновления данных: 19.10 в 10:40
Идентификатор: J_i_bIOA0h5AIi4R
Категории: Базы данных, 🇷🇺 Российские сервисы

ydb/ydb-mcp

YDB MCP

Usage

Via uvx

Example: Using Anonymous Authentication

Via pipx

Example: Using Anonymous Authentication

Часто задаваемые вопросы

Похожие MCP-сервера

bytebase/dbhub

c4pt0r/mcp-server-tidb

jparkerweb/mcp-sqlite

crystaldba/postgres-mcp

f4ww4z/mcp-mysql-server

wenb1n-dev/mysql_mcp_server_pro