Consultar Supabase en solo lectura en el IDE, bajo tres niveles de seguridad

Para quién

Esta guía es para quien sigue usando este Query MCP de la comunidad y quiere ejecutar SQL con seguridad en un IDE o llamar a la Supabase Management API. La vía principal oficial es instalar supabase-mcp-server con pipx y engancharlo por stdio a Cursor, Windsurf o Cline. El autor ha declarado que ya no lo mantiene de forma activa y apunta al repositorio sucesor oficial. Si quieres una opción de largo plazo, mira primero el sucesor; no trates este repositorio como única entrada.

Repositorio sucesor:

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

Encaja con quien primero ejecuta SQL en modo read-only. La evidencia indica que se puede controlar read-only / read-write, hacer risk level assessment en tiempo de ejecución y clasificar el SQL en safe, write, destructive. No encaja empezar con sentencias destructive, ni tratar nombres de función de herramienta no citados como interfaces demostradas.

Primera prueba en 3 minutos

La instalación recomendada oficialmente está abajo. Requisito: esta máquina puede ejecutar pipx. La ubicación de configuración es un cliente MCP que admite stdio. No tratar uv pip install como otra instalación preferida al mismo tiempo.

pipx install supabase-mcp-server

Página de este repositorio:

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

Primera prueba: la capacidad SQL oficial de solo lectura. Pon el modo de ejecución en read-only y corre una consulta que no cambie datos. Señal de éxito: vuelven resultados, no un bloqueo de la política de seguridad. Solo lectura igual conecta a tu Supabase/Postgres; no leerlo como sin red y sin acceso a la base. El servidor usa asyncpg y ya no depende de bibliotecas de desarrollo PostgreSQL locales; solo sigues necesitando PostgreSQL si ejecutas una local Supabase instance.

Casos de uso

Caso 1: consulta de datos en solo lectura. Corresponde a Control read-only ... SQL query execution. La evidencia no escribe nombre de función de herramienta ni SQL de ejemplo; no inventarlos. Si funciona, se ven resultados, a veces con una calificación de riesgo.

Caso 2: cambiar schema o llamar Management API / Auth Admin SDK. Corresponde a manage schema changes, call the Supabase Management API, use Auth Admin SDK. Esto es escritura: antes de la llamada, confirma el modo write y mira en la seguridad de tres niveles si está marcado safe, write o destructive. Señal de éxito: el cambio lo aceptan los controles de seguridad. Si no hay pasos oficiales de deshacer, no lo describas como reversible a la ligera.

Límites de uso

El autor ya no lo mantiene de forma activa. Los modos solo lectura / lectura-escritura y los tres niveles de seguridad son controles integrados, no riesgo cero. La evidencia no da un registro concreto de herramientas, nombres de variables secretas ni pasos de desinstalación. La instalación uv es solo otro comando de gestor de paquetes en la documentación; no la pongas junto a la vía principal pipx.