Servidor MCP de Supabase

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con bases de datos de Supabase. Este servidor proporciona herramientas para consultar tablas y generar tipos de TypeScript mediante la interfaz MCP.

Características

• Tablas de consulta : ejecute consultas en cualquier tabla con soporte para:

  • Selección de esquema

  • Filtrado de columnas

  • Cláusulas where con múltiples operadores

  • Paginación

  • Manejo de errores

• Generación de tipos : genere tipos TypeScript para su base de datos:

  • Soporte para cualquier esquema (público, auth, api, etc.)

  • Funciona con proyectos Supabase tanto locales como remotos

  • Salida directa a consola

  • Detección automática de referencias de proyectos

Prerrequisitos

1. Node.js (v16 o superior)

2. Un proyecto de Supabase (ya sea local o alojado)

3. Supabase CLI (para generación de tipos)

Instalación

1. Clonar el repositorio:

2. Instalar dependencias:

3. Instale la CLI de Supabase (necesaria para la generación de tipos):

Configuración

1. Obtenga sus credenciales de Supabase:

   • Para proyectos alojados:

     1. Vaya al panel de control de su proyecto Supabase

     2. Vaya a Configuración del proyecto > API

     3. Copia la URL del proyecto y la clave service_role (NO la clave anónima)

   • Para proyectos locales:

     1. Inicie su instancia local de Supabase

     2. Utilice la URL local (normalmente http://localhost:54321 )

     3. Utilice su clave de servicio local

2. Configurar variables de entorno:

3. Construir el servidor:

Integración con Claude Desktop

1. Abra la configuración de Claude Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Ventanas: %APPDATA%\Claude\claude_desktop_config.json

   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Agregue la configuración del servidor:

Integración con la extensión VSCode

1. Abrir la configuración de VSCode:

   • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

   • Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

   • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

2. Agregue la configuración del servidor (mismo formato que Claude Desktop).

Ejemplos de uso

Consulta de tablas

Generando tipos

Herramientas disponibles

tabla de consulta

Consultar una tabla específica con selección de esquema y soporte de cláusula where.

Parámetros:

• schema (opcional): esquema de base de datos (predeterminado a público)

• table (obligatorio): Nombre de la tabla a consultar

• select (opcional): lista de columnas separadas por comas

• where (opcional): Matriz de condiciones con:

  • column : Nombre de la columna

  • operator : Uno de: eq, neq, gt, gte, lt, lte, like, ilike, is

  • value : Valor con el que comparar

generar_tipos

Genere tipos TypeScript para su esquema de base de datos Supabase.

Parámetros:

• schema (opcional): esquema de base de datos (predeterminado a público)

Solución de problemas

Problemas de generación de tipos

1. Asegúrese de que Supabase CLI esté instalado:

2. Para proyectos locales:

   • Asegúrese de que su instancia local de Supabase se esté ejecutando

   • Verifique que su clave service_role sea correcta

3. Para proyectos alojados:

   • Confirme que la referencia de su proyecto sea correcta (extraída de la URL)

   • Verifique que esté utilizando la clave service_role, no la clave anon

Problemas de consulta

1. Comprueba tu esquema y los nombres de las tablas

2. Verificar los nombres de las columnas en las cláusulas select y where

3. Asegúrese de que su clave service_role tenga los permisos necesarios

Contribuyendo

1. Bifurcar el repositorio

2. Crea tu rama de funciones: git checkout -b feature/my-feature

3. Confirme sus cambios: git commit -am 'Add my feature'

4. Empujar a la rama: git push origin feature/my-feature

5. Enviar una solicitud de extracción

Licencia

Licencia MIT: consulte el archivo de LICENCIA para obtener más detalles