schemagate

schemagate — MCP-сервер сообщества (автор — ashishsinha1602). Выбор схемы для text-to-SQL с учётом прав вызывающего. Ставится через pip или через Docker. Лицензия Apache-2.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
ashishsinha1602
Лицензия
Apache-2.0
Транспорт
stdio
Авторизация
other
ОС
linux, macos, windows
Языки
python

Уровень риска: medium

Читает схему и данные базы с учётными данными из окружения; без OAuth доверяет ролям, переданным клиентом. Все инструменты только для чтения.

Настройка клиентов

cursor
{
    "code": "{\"mcpServers\": {\"schemagate\": {\n  \"command\": \"uvx\", \"args\": [\"--from\", \"schemagate[mcp,postgres]\", \"schemagate-mcp\"],\n  \"env\": {\"SCHEMAGATE_DATABASE_URL\": \"postgresql+psycopg://user:password@localhost/app\"}}}}",
    "lang": "json",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

schemagate — инструмент для text-to-SQL, который отправляет модели только те таблицы, что нужны для вопроса, и только те, которые вызывающему разрешено читать. Обычно в промпт вставляют всю схему базы: для двадцати таблиц это терпимо, для двух тысяч — разорительно. По данным автора, schemagate сокращает объём схемы в промпте в среднем на 91,1% на базах от 50 таблиц. В README приводятся и результаты на рейтинге BIRD Mini-Dev для SQLite, PostgreSQL и MySQL.

Главная идея — фильтрация по правам до выбора таблиц. Если отбор схемы не учитывает личность пользователя, модель получает таблицу, которую пользователь читать не может, пишет корректный SQL, построчная защита (RLS) отбрасывает все строки, и человек видит «записей не найдено» вместо отказа в доступе. В schemagate закрытая таблица просто отсутствует в промпте, а закрытый и несуществующий объект возвращают одинаковую ошибку, так что сам факт существования не раскрывается.

MCP-сервер предоставляет девять инструментов, все только для чтения:

  • select_schema — DDL для вопроса с учётом прав вызывающего;
  • list_objects — что видит этот вызывающий;
  • describe_object — полный DDL одного объекта;
  • run_query — выполняет один запрос на чтение и отклоняет его, если в нём есть недоступные объекты;
  • semantic_query — запрос на чтение, строки которого модель сервера фильтрует или аннотирует по тексту столбца;
  • answer и deep_answer — ответ на вопрос, второй может исследовать базу в несколько шагов;
  • refresh_catalog и health.

Инструменты принимают principal и roles; без них вызывающий считается анонимным и видит только неограниченные объекты. Каждое решение записывается в журнал аудита (без данных строк и без имён скрытых объектов), который можно подписывать постквантовой подписью ML-DSA-65.

Кому подойдёт

  • Командам, строящим SQL-агентов на больших базах, где схема не помещается в промпт.
  • Корпоративным аналитическим платформам с разграничением доступа к таблицам.
  • Администраторам, которым нужен проверяемый след того, что модель видела.

Похожие серверы — в категории базы данных.

Установка

Базовая установка — pip install schemagate: одна зависимость (SQLAlchemy), без ключа API и загрузки моделей. Для MCP-сервера нужен дополнительный пакет mcp и драйвер базы: postgres, mysql, mssql или oracle (SQLite драйвер не нужен). Сертифицированы SQLite, PostgreSQL, Oracle, SQL Server и MySQL, частично DuckDB. Быстрый старт без своей базы — встроенная демосхема (--url demo). Адрес базы с паролем передавайте в env (SCHEMAGATE_DATABASE_URL), а не в аргументах: аргументы команд видны всем процессам на машине. Для инструментов, где отвечает модель сервера, используются ключи ANTHROPIC_API_KEY, OPENAI_API_KEY или GEMINI_API_KEY; есть и путь с локальной моделью без ключа.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add schemagate -- uvx --from "schemagate[mcp]" schemagate-mcp --url demo

Команда для Claude Code подключает демосхему; замените --url demo на свою базу. Тот же JSON README приводит для Cursor, Windsurf и Zed. Нужен uv; без него установите pip install 'schemagate[mcp,postgres]' и запускайте schemagate-mcp.

Проверка

Попробуйте в демосхеме: спросите «зарплата по сотрудникам» без ролей — таблица hr_compensation не появится; с ролью payroll она окажется первой.

Примеры задач

Какие таблицы нужны, чтобы посчитать выручку по месяцам? Покажи их DDL и выполни запрос.
Покажи, какие объекты доступны роли finance, и найди товары ниже уровня дозаказа.

Риски

  • Доверие к личности. Без OAuth сервер верит principal и roles, которые передаёт клиент: любой, кто достучится до транспорта, может заявить роль и прочитать её данные, ведь run_query возвращает строки. Используйте stdio или HTTP за аутентификацией; переменные SCHEMAGATE_MCP_OAUTH_ISSUER и SCHEMAGATE_MCP_OAUTH_AUDIENCE включают проверку токенов.
  • Учётные данные базы храните в переменных окружения, а не в аргументах.
  • Внешние модели. Инструменты answer, semantic_query и переранжирование отправляют модели метаданные и текст; описания схемы без ключа строятся по метаданным, без строк.

Частые вопросы

Нужен ли ключ API?

Для выбора схемы и запросов нет; ключ нужен только инструментам, где отвечает модель сервера.

Может ли агент изменить данные?

Нет, все девять инструментов только читают, а run_query выполняет один запрос на чтение.

Какие базы поддерживаются?

SQLite, PostgreSQL, Oracle, SQL Server и MySQL сертифицированы; DuckDB работает частично.

Основы протокола — на странице что такое MCP-сервер.

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

dbx

Запросы агентов к базам данных через подключения, настроенные в DBX.

Риск: medium Лицензия: Apache-2.0 ★ 29 956

XERJ

Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.

Риск: high Лицензия: Apache-2.0 ★ 18 558

MCP Toolbox for Databases

MCP Toolbox for Databases от Google подключает агента к вашим базам данных.

Риск: medium Лицензия: Apache-2.0 ★ 16 830

kubeshark

Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.

Риск: medium Лицензия: Apache-2.0 ★ 12 135

Источники