Servidor MCP de Supabase

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite que las herramientas de IA interactúen con las bases de datos de Supabase. Este servidor proporciona herramientas para leer, crear, actualizar y eliminar registros en las tablas de Supabase.

Características

• Leer filas de cualquier tabla de Supabase con filtrado y selección de columnas

• Crear uno o varios registros en tablas

• Actualizar registros según las condiciones del filtro

• Eliminar registros según las condiciones del filtro

• Descripciones completas de herramientas para la comprensión del modelo de IA

• Manejo seguro de solicitudes y respuestas con Pydantic

• Compatibilidad con Docker para una implementación sencilla

Prerrequisitos

• Python 3.9+

• Docker y Docker Compose

• Proyecto Supabase con clave de rol de servicio

• IDE de IA compatible con FastMCP

Instalación

1. Clonar el repositorio:

2. Cree un archivo .env con sus credenciales de Supabase:

3. Construya e inicie el contenedor:

El servidor estará disponible en http://localhost:8000 .

Comandos de administración de Docker

Solución de problemas de Docker

1. Si el contenedor no se inicia:

   # Check logs docker-compose logs -f # Check container status docker-compose ps # Remove and rebuild docker-compose down docker-compose up --build

2. Si surgen conflictos de puertos:

   # Stop any existing containers using port 8000 docker-compose down # Or modify the port in docker-compose.yml # ports: # - "8000:8000" # Change the first number to an available port

3. Si las variables de entorno no se cargan:

   # Verify .env file exists and has correct values cat .env # Check environment variables in container docker-compose exec mcp-server env

Configuración de MCP en su IDE de IA

Pasos de configuración general

1. Abra la configuración/preferencias de su IDE de IA

2. Vaya a la sección de configuración de MCP o AI

3. Agregue un nuevo servidor MCP con la siguiente configuración:

Instrucciones específicas de IDE

Cursor

1. Abrir Configuración (⌘, o Ctrl+,)

2. Ir a la sección "IA"

3. En "Servidores MCP", haga clic en "Agregar servidor".

4. Utilice la configuración anterior

5. Reiniciar el cursor para aplicar los cambios

VS Code con extensiones de IA

1. Abrir la paleta de comandos (⌘⇧P o Ctrl+Shift+P)

2. Busca "MCP" o "Configuración de IA"

3. Agregar nueva configuración de servidor MCP

4. Utilice la configuración anterior

5. Recargar la ventana de VS Code

IDE de JetBrains con complementos de IA

1. Abrir Configuración (⌘, o Ctrl+Alt+S)

2. Vaya a "Herramientas" → "IA" → "Servidores MCP".

3. Haga clic en "+" para agregar un nuevo servidor

4. Utilice la configuración anterior

5. Reinicie el IDE para aplicar los cambios

Verificación de la conexión MCP

1. Verifique la barra de estado de su IDE para ver el estado del servidor MCP

2. Busque un indicador verde o el mensaje "MCP conectado"

3. Intente utilizar funciones de IA que requieran acceso a bases de datos

4. Verifique los registros de Docker para detectar cualquier problema de conexión:

   docker-compose logs -f

Uso

1. Inicie el servidor MCP:

2. Configure su herramienta de IA para utilizar el servidor MCP:

Herramientas disponibles

leer_filas

Leer filas de una tabla Supabase con filtrado y selección de columnas opcionales.

Ejemplo de uso:

crear_registros

Crea uno o más registros en una tabla de Supabase.

Ejemplo de uso:

actualizar_registros

Actualizar registros en una tabla de Supabase según las condiciones del filtro.

Ejemplo de uso:

eliminar_registros

Eliminar registros de una tabla de Supabase según las condiciones del filtro.

Ejemplo de uso:

Consideraciones de seguridad

• Utilice siempre la clave de rol de servicio en un entorno seguro

• Nunca exponga la clave del rol de servicio en el código del lado del cliente

• Utilice políticas de seguridad de nivel de fila adecuadas en Supabase

• Considere implementar una limitación de velocidad para el uso en producción

Contribuyendo

1. Bifurcar el repositorio

2. Crear una rama de características

3. Confirme sus cambios

4. Empujar hacia la rama

5. Crear una solicitud de extracción

Licencia

Instituto Tecnológico de Massachusetts (MIT)