Query | MCP server for Supabase
Управляет Supabase через IDE: SQL-запросы, схема, API, аутентификация с контролями безопасности и версионированием.
Описание
Query MCP — это MCP-сервер для Supabase на Python 3.12+, совместимый с Cursor, Windsurf, Cline. Обеспечивает выполнение SQL с трехступенчатой безопасностью (safe, write, destructive), автоматическое версионирование миграций, доступ к Management API и Auth Admin SDK. Поддерживает логи, анализ рисков. Идеален для безопасного управления БД в чат-интерфейсе IDE. Проект устарел; рекомендуется официальный от Supabase.
Возможности
Выполнение SQL-запросов
Запуск PostgreSQL-запросов с валидацией рисков, транзакциями и режимами безопасности (read-only, write, destructive).
Управление схемой БД
Просмотр схем, таблиц, автоматическое версионирование миграций для изменений.
Management API
Доступ к Supabase API с безопасностью: GET всегда, POST/PUT в unsafe, блокировка destructive.
Auth Admin SDK
Методы для управления пользователями: создание, удаление, приглашения, обновления через Python SDK.
Доступ к логам
Получение логов из сервисов Supabase (postgres, auth, storage и т.д.) с фильтрами.
Универсальная безопасность
Единый менеджер рисков для всех операций с уровнями low/medium/high/extreme и подтверждениями.
Установка
Установка требует Python 3.12+. Рекомендуется pipx:
pipx install supabase-mcp-server
Или через uv:
uv pip install supabase-mcp-server
Для разработки из исходников:
uv venv
source .venv/bin/activate # macOS/Linux или .venv\Scripts\activate (Windows)
uv pip install -e .
Конфигурация через переменные окружения (QUERY_API_KEY обязательно с thequery.dev) или .env в ~/.config/supabase-mcp/. Настройка в клиенте (Cursor, Windsurf и т.д.) с указанием команды и env.