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 доверяет ролям, переданным клиентом. Все инструменты только для чтения.
Настройка клиентов
{
"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.
XERJ
Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.
MCP Toolbox for Databases
MCP Toolbox for Databases от Google подключает агента к вашим базам данных.
kubeshark
Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.