remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides enhanced database interactions through Supabase, including SQL query processing, PostgREST API access, SQL to REST conversion, and optimized response formatting for UI components, with improved error handling and authentication.
Implements strict TypeScript types for response handling, providing type safety for database interactions and standardized JSON response formats.

Servidor MCP de Windsurf Supabase

Un servidor MCP optimizado para Windsurf para la integración de Supabase

Este repositorio contiene una versión optimizada para Windsurf del servidor Supabase MCP, optimizada específicamente para funcionar a la perfección con el Editor Windsurf. Se basa en el estándar del Protocolo de Contexto de Modelo (MCP), incorporando mejoras cruciales para optimizar la gestión de errores, el formato de respuestas y el procesamiento de consultas SQL.

Modificaciones clave para el windsurf

1. Manejo mejorado de errores

Nos enfrentamos a varios desafíos con el sistema original de manejo de errores:

Las consultas SQL mal formadas causarían fallos silenciosos
Los errores de análisis de flujo eran difíciles de depurar
Los mensajes de error no eran compatibles con LLM

Nuestras soluciones:

Se agregaron respuestas de error estructuradas con contexto detallado
Mensajes de error mejorados para una mejor comprensión del LLM
Se agregó validación para la estructura de la consulta SQL
Detección y recuperación de errores de transmisión mejoradas

2. Formato de respuesta

El formato de respuesta original tenía limitaciones:

Estructura JSON inconsistente en diferentes tipos de respuesta
Metadatos faltantes para los componentes de la interfaz de usuario
Seguridad de tipo limitada

Nuestras mejoras:

Formato de respuesta JSON estandarizado
Se agregaron metadatos para la generación de componentes de UI
Se implementaron tipos TypeScript estrictos
Se agregó soporte para la transmisión de estructuras de datos complejas

3. Conversión de SQL a REST

Mejoramos la conversión de SQL a REST:

Se agregó soporte para operaciones SQL más complejas
Validación de consultas mejorada
Mejor manejo de JOINs y subconsultas
Mensajes de error mejorados para SQL no válido

4. Autenticación y encabezados

Mejoras clave en el manejo de la autenticación:

Gestión flexible de claves API
Soporte para autenticación de token de portador
Mejor gestión de encabezados para solicitudes PostgREST
Validación de seguridad mejorada

Integración con Windsurf

Este servidor MCP está diseñado específicamente para funcionar con el editor Windsurf y proporciona:

Interacciones fluidas con bases de datos a través del lenguaje natural
Validación y corrección de consultas en tiempo real
Mensajes de error mejorados para una mejor depuración
Formato de respuesta optimizado para componentes de UI

Ejemplo de uso en windsurf

// Example of enhanced response handling
const response = await postgrestRequest({
  method: 'GET',
  path: '/todos?is_completed=eq.false',
});

// Response includes metadata for UI components
const { data, metadata } = response;

Instalación

Clonar este repositorio:

git clone https://github.com/hertzfelt/windsurf-supabase-mcp.git

Instalar dependencias:

npm install

Configure su conexión Supabase:

SUPABASE_URL=your_supabase_url
SUPABASE_KEY=your_supabase_key

Uso con Windsurf

Este servidor proporciona dos herramientas principales:

postgrestRequest : acceso mejorado a la API PostgREST

const result = await postgrestRequest({
  method: 'GET',
  path: '/users',
});

sqlToRest : Conversión de SQL a REST mejorada

const query = 'SELECT * FROM users WHERE age > 18';
const { method, path } = await sqlToRest({ sql: query });

Contribuyendo

¡Agradecemos sus contribuciones! Consulte nuestras Pautas de Contribución para obtener más información sobre nuestro código de conducta y el proceso para enviar solicitudes de incorporación de cambios.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un servidor de protocolo de contexto de modelo optimizado para integrar Supabase con el editor Windsurf, proporcionando interacciones de base de datos a través de lenguaje natural con manejo de errores mejorado y formato de respuesta.

Related Resources

Reddit Discussion about this server

Windsurf Supabase MCP Server