Supabase User MCP

Дайте каждому человеку и агенту собственную границу идентичности в базе данных.

Supabase User MCP — это независимый MCP-сервер плоскости данных с приоритетом безопасности для приложений, созданных на Supabase. Он предназначен для того, чтобы AI-клиенты могли работать с данными приложения от имени конкретного пользователя или агента, при этом PostgreSQL Row Level Security (RLS) остаётся финальным органом авторизации.

[!WARNING] Этот репозиторий находится в активной разработке M0. Он содержит только протокольный пробник без полномочий — а не разворачиваемый сервер пользовательских данных, — и его нельзя подключать к производственным данным.

Зачем это существует

Размещённый MCP-сервер Supabase — это инструмент плоскости управления для разработчика. Он управляет проектами, схемами, миграциями, функциями и операционными ресурсами под полномочиями разработчика. Supabase явно рекомендует использовать этот сервер для разработки и тестирования, а не для предоставления доступа клиентам или производственным данным.

Supabase User MCP исследует дополнительную проблему плоскости данных:

Цель — не сделать инъекцию подсказок невозможной. Цель — гарантировать, что скомпрометированная модель не сможет превысить полномочия предоставленной ей идентичности и возможностей.

Related MCP server: agent-sudo-mcp

Тезис безопасности

MCP client
    │ authenticated request
    ▼
Supabase User MCP
    ├── validates identity and request context
    ├── exposes a small, allowlisted tool surface
    ├── enforces limits, approval states, and audit metadata
    ▼
Supabase Data API / PostgREST
    ▼
PostgreSQL + RLS
    ├── caller and OAuth-client policy
    ├── tenant and capability policy
    └── row and operation policy

Проект следует шести незыблемым принципам:

1. Никакого мастер-ключа в пути запроса MCP. Публичный обработчик инструмента никогда не должен использовать service_role или секретный ключ для выполнения действий от имени пользователя.

2. База данных принимает окончательное решение. Проверки в приложении улучшают удобство использования; RLS и ограничения базы данных обеспечивают авторизацию.

3. Инструменты — это возможности, а не универсальная REST-консоль. Первоначальный сервер не будет предоставлять произвольные SQL, таблицы, схемы, имена RPC, URL-адреса или HTTP-методы.

4. Чтение и запись — это разные полномочия. Канонические или необратимые изменения используют поддерживаемый базой данных процесс предложения и утверждения.

5. Недоверенный контент остаётся данными. Результаты инструментов ограничены и помечаются как недоверенные; инъекция подсказок тестируется как проблема изоляции.

6. Утверждения требуют доказательств. Этап считается завершённым только тогда, когда проходят его позитивные, негативные, кросс-идентификационные и состязательные тесты.

Планируемая поверхность продукта

Первый полезный релиз намеренно узок:

• memory_search — ограниченный полнотекстовый или семантический поиск по авторизованным записям

• memory_get — получение одной авторизованной записи памяти по непрозрачному идентификатору

• memory_list_recent — список авторизованных недавних записей с жёстким ограничением количества страниц

• memory_append_observation — идемпотентное добавление неканонической информации

• memory_propose_change — подготовка канонического изменения для проверки человеком

• memory_get_proposal — проверка статуса утверждения без применения изменения

Названия описывают эталонную реализацию суверенной памяти. Адаптеры впоследствии могут сопоставить ту же модель возможностей с другими схемами приложений Supabase. См. полный каталог функций.

Текущий этап

Проект находится на этапе M0: протокольный и политический фундамент. Прежде чем код сервера будет считаться жизнеспособным, M0 должен решить два вопроса идентичности:

• Как удалённый HTTP MCP-сервер получает последующий токен Supabase, не нарушая требований MCP к привязке аудитории и передаче токенов.

• Как долговечные нечеловеческие субъекты предоставляются и отзываются, учитывая, что сервер OAuth Supabase в настоящее время документирует гранты кода авторизации и обновления токенов, а не грант client_credentials.

Это архитектурные барьеры, а не детали реализации. Локальное доказательство stdio и удалённый HTTP-сервис отслеживаются как отдельные профили развёртывания, пока удалённая цепочка идентичности не будет продемонстрирована из конца в конец.

Исполняемый спайк M0 теперь подтверждает строгую рабочую область TypeScript, согласование stdio MCP 2026-07-28, структурированную проверку ввода/вывода и намеренно неавторитетный инструмент. В нём нет клиента Supabase, учётных данных, сетевого доступа и операций с данными. См. подтверждение совместимости.

Попробуйте пробник совместимости M0

Предварительные требования: Node.js 22.20.0 и npm 11.19.0.

npm ci
npm run check
npm run build
npm start

npm start запускает JSON-RPC stdio-сервер для MCP-клиента 2026-07-28; это не интерактивное терминальное приложение. Единственный доступный инструмент — system_compatibility_probe, который не выполняет сетевых операций или операций с данными. Точные версии и команды проверки задокументированы в руководстве разработчика.

Дорожная карта

Каждый этап имеет результаты, зависимости, исключения и измеримые критерии завершения в дорожной карте разработки.

Документация

• Определение продукта — пользователи, задачи, границы и показатели успеха

• Архитектура — компоненты, границы доверия и профили развёртывания

• Каталог функций — предлагаемые инструменты и возможности платформы

• Модель безопасности — идентичности, возможности, RLS и утверждения

• Модель угроз — активы, злоумышленники, случаи злоупотреблений и меры защиты

• Дорожная карта — последовательность реализации и критерии выпуска

• Руководство разработчика — зафиксированный стек, структура и инженерные стандарты

• Подтверждение совместимости M0 — зафиксированные версии и доказательство протокола

• Архитектурные решения — важные решения и открытые вопросы

Вклад в проект

Наиболее ценными вкладами сегодня являются состязательные обзоры, предшествующий опыт, тест-кейсы политик и небольшие исправления документации. Пожалуйста, прочитайте CONTRIBUTING.md и GOVERNANCE.md перед открытием pull request. Отчёты о безопасности относятся к приватному процессу, описанному в SECURITY.md, а не к публичному issue.

Статус проекта и независимость

Supabase User MCP — это независимый проект с открытым исходным кодом. Он не является официальным продуктом Supabase и не одобрен компанией Supabase, Inc. Название «Supabase» используется для обозначения совместимости с платформой Supabase.

Лицензировано на условиях Apache License 2.0.