supabase-mcp-server
supabase-mcp-server — MCP-сервер сообщества (автор — alexander-zuev). SQL-запросы и обзор баз данных Supabase. Ставится через pip. Лицензия Apache-2.0.
Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- alexander-zuev
- Лицензия
- Apache-2.0
- Транспорт
- stdio
- Авторизация
- token_env
- ОС
- Не указана
- Языки
- python
Уровень риска: high
Доступ к БД, Management API и Auth Admin Supabase; изменения только в режиме live_dangerously, разрушительные — с подтверждением. Проект не поддерживается.
Настройка клиентов
{
"code": "{\n \"mcpServers\": {\n \"supabase\": {\n \"command\": \"/Users/username/.local/bin/supabase-mcp-server\", // update path\n \"env\": {\n \"QUERY_API_KEY\": \"your-api-key\", // Required - get your API key at thequery.dev\n \"SUPABASE_PROJECT_REF\": \"your-project-ref\",\n \"SUPABASE_DB_PASSWORD\": \"your-db-password\",\n \"SUPABASE_REGION\": \"us-east-1\", // optional, defaults to us-east-1\n \"SUPABASE_ACCESS_TOKEN\": \"your-access-token\", // optional, for management API\n \"SUPABASE_SERVICE_ROLE_KEY\": \"your-service-role-key\" // optional, for Auth Admin SDK\n }\n }\n }\n}",
"lang": "jsonc",
"notes": "Дословно из README",
"verified": "docs"
}
Что умеет
Query MCP — открытый MCP-сервер для Supabase. Через него IDE может безопасно выполнять SQL, управлять изменениями схемы, вызывать Supabase Management API и использовать Auth Admin SDK. Защитные механизмы встроены.
Важно: проект больше не развивается активно. Supabase выпустила собственный официальный MCP-сервер, и автор рекомендует перейти на него. По README официальный сервер не уступает по возможностям и будет развиваться дальше.
Возможности:
- SQL с оценкой риска. Запросы разбираются парсером PostgreSQL (pglast) и делятся на три уровня.
safe— только чтение (SELECT), всегда разрешено.write— изменение данных (INSERT, UPDATE, DELETE), нужен небезопасный режим.destructive— изменение схемы (DROP, CREATE), нужен небезопасный режим и подтверждение. - Инструменты БД —
get_schemas,get_tables,get_table_schema,execute_postgresql,confirm_destructive_operation,retrieve_migrationsи переключатель режимаlive_dangerously. - Автоматические миграции — каждая изменяющая операция сохраняется как версионированный скрипт миграции.
- Management API —
send_management_api_requestс проверкой безопасности. Чтение (GET) разрешено всегда, изменения — только в небезопасном режиме, а разрушительные операции вроде удаления проекта заблокированы полностью. - Auth Admin — список, создание, изменение и удаление пользователей, приглашения по email, генерация ссылок для входа.
- Логи —
retrieve_logsпо сервисам postgres, api_gateway, auth, storage, realtime, edge_functions, cron и другим.
Кому подойдёт
- Тем, кто уже пользуется этим сервером и поддерживает существующую настройку.
- Разработчикам на Supabase, которым важны трёхуровневая защита SQL и автоматические миграции.
- Для новых проектов автор рекомендует официальный MCP-сервер Supabase.
Похожие серверы — в категории базы данных.
Установка
Нужен Python 3.12 или новее. Установка: pipx install supabase-mcp-server (рекомендуется) или uv pip install supabase-mcp-server. С версии 0.4 нужен API-ключ QUERY_API_KEY, который выдаёт сайт thequery.dev; по README он бесплатный. Обязательные переменные — SUPABASE_PROJECT_REF, SUPABASE_DB_PASSWORD и SUPABASE_REGION. Для Management API нужен SUPABASE_ACCESS_TOKEN, для Auth Admin — SUPABASE_SERVICE_ROLE_KEY. Для удалённых проектов обязательно укажите правильный регион, иначе получите ошибку «Tenant or user not found». Поддерживаются только проекты на supabase.com и локальная разработка, своя установка Supabase не поддерживается.
Подключение к клиентам
Конфиги приведены дословно из README, комментарии в них — от автора. Подставьте свои значения и полный путь к исполняемому файлу (его покажет which supabase-mcp-server). Общий порядок — в инструкции как подключить MCP.
{
"mcpServers": {
"supabase": {
"command": "/Users/username/.local/bin/supabase-mcp-server", // update path
"env": {
"QUERY_API_KEY": "your-api-key", // Required - get your API key at thequery.dev
"SUPABASE_PROJECT_REF": "your-project-ref",
"SUPABASE_DB_PASSWORD": "your-db-password",
"SUPABASE_REGION": "us-east-1", // optional, defaults to us-east-1
"SUPABASE_ACCESS_TOKEN": "your-access-token", // optional, for management API
"SUPABASE_SERVICE_ROLE_KEY": "your-service-role-key" // optional, for Auth Admin SDK
}
}
}
}Claude Desktop требует полный абсолютный путь к исполняемому файлу, иначе будет ошибка «spawn ENOENT». В Cursor сервер добавляется в настройках MCP как команда supabase-mcp-server.
Проверка
Попросите агента показать схемы базы — сработает get_schemas. Затем запросите структуру одной таблицы через get_table_schema.
Примеры задач
Покажи таблицы в схеме public и связи между ними.Посмотри логи auth за последний час и найди ошибки входа.Риски
У сервера есть доступ к базе данных, Management API и администрированию пользователей. С включённым live_dangerously агент может менять и удалять данные, менять схему, удалять пользователей и рассылать приглашения. Защита по README: по умолчанию включён безопасный режим только для чтения, разрушительные операции требуют двухшагового подтверждения, а самые опасные (например удаление проекта) заблокированы. Все изменения выполняются в транзакциях и сохраняются как миграции. Не включайте небезопасный режим на продакшен-базе без необходимости.
Пароль БД, ключ сервисной роли и токен доступа — секреты: храните их в конфиге клиента или в глобальном .env и не коммитьте. Ключ сервисной роли обходит Row Level Security. Проект не поддерживается, поэтому исправлений не будет.
Частые вопросы
Стоит ли ставить этот сервер в новый проект?
Автор рекомендует официальный MCP-сервер Supabase: этот больше активно не развивается.
Почему «Tenant or user not found»?
Почти всегда неверно указан SUPABASE_REGION для удалённого проекта.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
dbx
Запросы агентов к базам данных через подключения, настроенные в DBX.
XERJ
Поиск для агентов с ответами и ссылками по локальному коду, документации и логам.
MCP Toolbox for Databases
MCP Toolbox for Databases от Google подключает агента к вашим базам данных.
kubeshark
Наблюдение за сетевым трафиком Kubernetes и анализ API в реальном времени.