Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas integrales para interactuar con bases de datos, almacenamiento y funciones perimetrales de Supabase. Este servidor permite una integración fluida entre los servicios de Supabase y las aplicaciones compatibles con MCP.
El servidor Supabase MCP actúa como un puente entre los clientes MCP y el conjunto de servicios de Supabase, proporcionando:
Operaciones de bases de datos con amplias capacidades de consulta
Gestión de almacenamiento para archivos y activos
Invocación de función de borde
Gestión de proyectos y organizaciones
Autenticación y gestión de usuarios
Control de acceso basado en roles
Related MCP server: Supabase MCP Server
El servidor está construido con TypeScript y sigue una arquitectura modular:
supabase-server/
├── src/
│ ├── index.ts # Main server implementation
│ └── types/
│ └── supabase.d.ts # Type definitions
├── package.json
├── tsconfig.json
├── config.json.example # Example configuration file
└── .env.example # Environment variables templateClase de servidor : implementa la interfaz del servidor MCP y maneja todas las solicitudes del cliente
Definiciones de tipo : definiciones completas de TypeScript para todas las operaciones
Configuración del entorno : gestión segura de la configuración mediante variables de entorno
Manejo de errores : Manejo de errores robusto con mensajes de error detallados
Node.js 16.x o superior
Un proyecto de Supabase con:
URL del proyecto
Clave de rol de servicio (para operaciones administrativas)
Token de acceso (para operaciones de gestión)
Cliente compatible con MCP
Para instalar Supabase Server para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install supabase-server --client claudeClonar el repositorio:
git clone https://github.com/DynamicEndpoints/supabase-mcp.git
cd supabase-mcpInstalar dependencias:
npm installCrear configuración de entorno:
cp .env.example .envConfigurar variables de entorno:
SUPABASE_URL=your_project_url_here
SUPABASE_KEY=your_service_role_key_here
SUPABASE_ACCESS_TOKEN=your_access_token_here # Required for management operationsCrear configuración del servidor:
cp config.json.example config.jsonConstruir el servidor:
npm run buildEl servidor admite una configuración exhaustiva mediante variables de entorno y un archivo config.json. A continuación, se detallan las opciones de configuración:
{
"server": {
"name": "supabase-server", // Server name
"version": "0.1.0", // Server version
"port": 3000, // Port number (if running standalone)
"host": "localhost" // Host address (if running standalone)
}
}{
"supabase": {
"project": {
"url": "your_project_url",
"key": "your_service_role_key",
"accessToken": "your_access_token"
},
"storage": {
"defaultBucket": "public", // Default storage bucket
"maxFileSize": 52428800, // Max file size in bytes (50MB)
"allowedMimeTypes": [ // Allowed file types
"image/*",
"application/pdf",
"text/*"
]
},
"database": {
"maxConnections": 10, // Max DB connections
"timeout": 30000, // Query timeout in ms
"ssl": true // SSL connection
},
"auth": {
"autoConfirmUsers": false, // Auto-confirm new users
"disableSignup": false, // Disable public signups
"jwt": {
"expiresIn": "1h", // Token expiration
"algorithm": "HS256" // JWT algorithm
}
}
}
}{
"logging": {
"level": "info", // Log level
"format": "json", // Log format
"outputs": ["console", "file"], // Output destinations
"file": {
"path": "logs/server.log", // Log file path
"maxSize": "10m", // Max file size
"maxFiles": 5 // Max number of files
}
}
}{
"security": {
"cors": {
"enabled": true,
"origins": ["*"],
"methods": ["GET", "POST", "PUT", "DELETE", "OPTIONS"],
"allowedHeaders": ["Content-Type", "Authorization"]
},
"rateLimit": {
"enabled": true,
"windowMs": 900000, // 15 minutes
"max": 100 // Max requests per window
}
}
}{
"monitoring": {
"enabled": true,
"metrics": {
"collect": true,
"interval": 60000 // Collection interval in ms
},
"health": {
"enabled": true,
"path": "/health" // Health check endpoint
}
}
}Consulte config.json.example para obtener un archivo de configuración de ejemplo completo.
Agregue el servidor a su configuración de MCP (cline_mcp_settings.json):
{
"mcpServers": {
"supabase": {
"command": "node",
"args": ["path/to/supabase-server/build/index.js"],
"env": {
"SUPABASE_URL": "your_project_url",
"SUPABASE_KEY": "your_service_role_key",
"SUPABASE_ACCESS_TOKEN": "your_access_token"
},
"config": "path/to/config.json" // Optional: path to configuration file
}
}
}Cree un nuevo registro en una tabla con soporte para devolver campos específicos.
{
table: string;
data: Record<string, any>;
returning?: string[];
}Ejemplo:
{
table: "users",
data: {
name: "John Doe",
email: "john@example.com"
},
returning: ["id", "created_at"]
}Leer registros con filtrado avanzado, uniones y selección de campos.
{
table: string;
select?: string[];
filter?: Record<string, any>;
joins?: Array<{
type?: 'inner' | 'left' | 'right' | 'full';
table: string;
on: string;
}>;
}Ejemplo:
{
table: "posts",
select: ["id", "title", "user.name"],
filter: { published: true },
joins: [{
type: "left",
table: "users",
on: "posts.user_id=users.id"
}]
}Actualice registros con capacidades de filtrado y devolución.
{
table: string;
data: Record<string, any>;
filter?: Record<string, any>;
returning?: string[];
}Ejemplo:
{
table: "users",
data: { status: "active" },
filter: { email: "john@example.com" },
returning: ["id", "status", "updated_at"]
}Eliminar registros con capacidades de filtrado y devolución.
{
table: string;
filter?: Record<string, any>;
returning?: string[];
}Ejemplo:
{
table: "posts",
filter: { status: "draft" },
returning: ["id", "title"]
}Sube archivos a Supabase Storage con opciones configurables.
{
bucket: string;
path: string;
file: File | Blob;
options?: {
cacheControl?: string;
contentType?: string;
upsert?: boolean;
};
}Ejemplo:
{
bucket: "avatars",
path: "users/123/profile.jpg",
file: imageBlob,
options: {
contentType: "image/jpeg",
upsert: true
}
}Descargar archivos de Supabase Storage.
{
bucket: string;
path: string;
}Ejemplo:
{
bucket: "documents",
path: "reports/annual-2023.pdf"
}Invocar funciones de Supabase Edge con parámetros y opciones personalizadas.
{
function: string;
params?: Record<string, any>;
options?: {
headers?: Record<string, string>;
responseType?: 'json' | 'text' | 'arraybuffer';
};
}Ejemplo:
{
function: "process-image",
params: {
url: "https://example.com/image.jpg",
width: 800
},
options: {
responseType: "json"
}
}Enumere usuarios con soporte de paginación.
{
page?: number;
per_page?: number;
}Crear un nuevo usuario con metadatos.
{
email: string;
password: string;
data?: Record<string, any>;
}Actualizar los detalles del usuario.
{
user_id: string;
email?: string;
password?: string;
data?: Record<string, any>;
}Eliminar un usuario.
{
user_id: string;
}Asignar un rol a un usuario.
{
user_id: string;
role: string;
}Eliminar un rol de un usuario.
{
user_id: string;
role: string;
}El servidor proporciona mensajes de error detallados para escenarios comunes:
Parámetros no válidos
Errores de autenticación
Problemas de permisos
Limitación de velocidad
Errores de red
Restricciones de la base de datos
Los errores se devuelven en un formato estandarizado:
{
code: ErrorCode;
message: string;
details?: any;
}npm testnpm run buildnpm run lintEl paquete evals carga un cliente mcp que ejecuta el archivo index.ts, por lo que no es necesario reconstruir entre pruebas. Puede cargar variables de entorno prefijando el comando npx. Puede encontrar la documentación completa aquí .
OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.tsBifurcar el repositorio
Crear una rama de características
Confirme sus cambios
Empujar hacia la rama
Crear una solicitud de extracción
Licencia MIT: consulte LICENCIA para obtener más detalles
Para obtener ayuda, por favor:
Verifique los problemas para detectar problemas/soluciones existentes
Crear un nuevo problema con pasos de reproducción detallados
Incluya mensajes de error relevantes y detalles del entorno
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
No tool schema history has been recorded yet.
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
MCP server for interacting with the Supabase platform
Butterbase MCP server — manage your backend: schemas, auth, functions, storage, RAG, deploys.
The official MCP Server for the Mux API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/DynamicEndpoints/supabase-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
