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

Clonar el repositorio:

git clone https://github.com/yourusername/supabase-mcp.git
cd supabase-mcp

Cree un archivo .env con sus credenciales de Supabase:

cp .env.example .env
# Edit .env with your Supabase credentials:
# SUPABASE_URL=your-project-url
# SUPABASE_KEY=your-service-role-key

Construya e inicie el contenedor:

# Build and start in detached mode
docker-compose up --build -d

# To view logs
docker-compose logs -f

# To stop the container
docker-compose down

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

Comandos de administración de Docker

# Start the container
docker-compose up

# Start in detached mode (background)
docker-compose up -d

# Stop the container
docker-compose down

# View logs
docker-compose logs -f

# Rebuild the container
docker-compose up --build

# Check container status
docker-compose ps

# Restart the container
docker-compose restart

Solución de problemas de Docker

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
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
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

Abra la configuración/preferencias de su IDE de IA
Vaya a la sección de configuración de MCP o AI
Agregue un nuevo servidor MCP con la siguiente configuración:

{
  "name": "Supabase MCP",
  "command": "docker-compose",
  "args": ["up"],
  "cwd": "/path/to/supabase-mcp"
}

Instrucciones específicas de IDE

Cursor

Abrir Configuración (⌘, o Ctrl+,)
Ir a la sección "IA"
En "Servidores MCP", haga clic en "Agregar servidor".
Utilice la configuración anterior
Reiniciar el cursor para aplicar los cambios

VS Code con extensiones de IA

Abrir la paleta de comandos (⌘⇧P o Ctrl+Shift+P)
Busca "MCP" o "Configuración de IA"
Agregar nueva configuración de servidor MCP
Utilice la configuración anterior
Recargar la ventana de VS Code

IDE de JetBrains con complementos de IA

Abrir Configuración (⌘, o Ctrl+Alt+S)
Vaya a "Herramientas" → "IA" → "Servidores MCP".
Haga clic en "+" para agregar un nuevo servidor
Utilice la configuración anterior
Reinicie el IDE para aplicar los cambios

Verificación de la conexión MCP

Verifique la barra de estado de su IDE para ver el estado del servidor MCP
Busque un indicador verde o el mensaje "MCP conectado"
Intente utilizar funciones de IA que requieran acceso a bases de datos
Verifique los registros de Docker para detectar cualquier problema de conexión:
docker-compose logs -f

Uso

Inicie el servidor MCP:

docker-compose up

Configure su herramienta de IA para utilizar el servidor MCP:

{
  "mcpServers": {
    "supabase": {
      "command": "docker-compose",
      "args": ["up"]
    }
  }
}

Herramientas disponibles

leer_filas

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

Ejemplo de uso:

{
  "table_name": "users",
  "columns": ["id", "name"],
  "filters": { "age": { "gt": 18 } },
  "limit": 10
}

crear_registros

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

Ejemplo de uso:

{
  "table_name": "users",
  "records": [
    { "name": "John", "age": 30 },
    { "name": "Jane", "age": 25 }
  ]
}

actualizar_registros

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

Ejemplo de uso:

{
  "table_name": "users",
  "filters": { "status": "inactive" },
  "updates": { "status": "active" }
}

eliminar_registros

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

Ejemplo de uso:

{
  "table_name": "users",
  "filters": { "id": 1 }
}

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

Bifurcar el repositorio
Crear una rama de características
Confirme sus cambios
Empujar hacia la rama
Crear una solicitud de extracción

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Supabase MCP Server

Integrations