Consultar o Supabase só de leitura no IDE, sob três níveis de segurança

Para quem

Este guia é para quem ainda usa este Query MCP da comunidade e quer executar SQL em segurança num IDE ou chamar a Supabase Management API. O caminho principal oficial é instalar supabase-mcp-server com pipx e ligá-lo por stdio ao Cursor, Windsurf ou Cline. O autor declarou que já não o mantém ativamente e aponta para o repositório sucessor oficial. Se quiseres uma opção de longo prazo, vê primeiro o sucessor; não trates este repositório como única entrada.

Repositório sucessor:

https://github.com/supabase-community/supabase-mcp

Encaixa em quem primeiro corre SQL em modo read-only. A evidência diz que se pode controlar read-only / read-write, fazer risk level assessment em tempo de execução e classificar o SQL em safe, write, destructive. Não serve começar com instruções destructive, nem tratar nomes de função de ferramenta não citados como interfaces comprovadas.

Primeira tentativa em 3 minutos

A instalação oficialmente recomendada está abaixo. Pré-requisito: esta máquina consegue executar pipx. O local da configuração é um cliente MCP que suporte stdio. Não tratar uv pip install como outra instalação preferida ao mesmo tempo.

pipx install supabase-mcp-server

Página deste repositório:

https://github.com/alexander-zuev/supabase-mcp-server

Primeira tentativa: a capacidade SQL oficial só de leitura. Põe o modo de execução em read-only e corre uma consulta que não altere dados. Sinal de sucesso: voltam resultados, não um bloqueio da política de segurança. Só leitura mesmo assim liga ao teu Supabase/Postgres; não ler como sem rede e sem acesso à base. O servidor usa asyncpg e já não depende de bibliotecas de desenvolvimento PostgreSQL locais; só precisas de PostgreSQL se correres uma local Supabase instance.

Casos de uso

Caso 1: consulta de dados só de leitura. Corresponde a Control read-only ... SQL query execution. A evidência não escreve nome de função de ferramenta nem SQL de exemplo; não os inventar. Em sucesso, vê-se resultados, por vezes com uma classificação de risco.

Caso 2: alterar schema ou chamar Management API / Auth Admin SDK. Corresponde a manage schema changes, call the Supabase Management API, use Auth Admin SDK. Isto é escrita: antes da chamada, confirmar o modo write e ver na segurança de três níveis se está marcado safe, write ou destructive. Sinal de sucesso: a alteração é aceite pelos controlos de segurança. Sem passos oficiais de anulação, não descrever como facilmente reversível.

Limites de uso

O autor já não mantém ativamente. Os modos só leitura / leitura-escrita e os três níveis de segurança são controlos embutidos, não risco zero. A evidência não dá um registo concreto de ferramentas, nomes de variáveis secretas nem passos de desinstalação. A instalação uv é só outro comando de gestor de pacotes na documentação; não a pôr ao lado do caminho principal pipx.