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, разрушительные — с подтверждением. Проект не поддерживается.

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

windsurf
{
    "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.

Риск: 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

Источники