Supabase MCP Server - Docker Image

Docker wrapper for the Supabase MCP Server, enabling AI assistants to interact with Supabase projects through the Model Context Protocol.

What is this?

This repository provides a containerized version of the Supabase MCP Server, making it easy to run with Docker and integrate with AI development tools like Claude Code, Cursor, and Windsurf.

Quick Start

docker run -e SUPABASE_ACCESS_TOKEN=your_token \
           -e PROJECT_REF=your_project_ref \
           ghcr.io/david16digits/supabase-mcp-docker

Configuration

Required Environment Variables

• SUPABASE_ACCESS_TOKEN: Your Supabase access token
  • Get from: Supabase Dashboard → Account → Access Tokens

Optional Environment Variables

• PROJECT_REF: Scope to a specific Supabase project (recommended for security)
• API_URL: Custom Supabase API URL (default: https://api.supabase.com)

Example with Docker Compose

version: '3.8'
services:
  supabase-mcp:
    image: ghcr.io/david16digits/supabase-mcp-docker
    environment:
      - SUPABASE_ACCESS_TOKEN=${SUPABASE_ACCESS_TOKEN}
      - PROJECT_REF=${PROJECT_REF}
    restart: unless-stopped

Features

The Supabase MCP Server provides AI assistants with tools to:

• Database Management: List tables, execute SQL, apply migrations
• Edge Functions: Deploy and manage Supabase Edge Functions
• Development: Generate TypeScript types, access project config
• Debugging: View logs and security advisories
• Documentation: Search Supabase docs for up-to-date information
• Branching: Work with development branches (paid plans)

Security Best Practices

⚠️ Important: Always follow these security guidelines:

1. Use Read-Only Mode: Add --read-only flag for read-only database access
2. Project Scoping: Always set PROJECT_REF to limit access to one project
3. Development Only: Use with development projects, not production
4. Never Commit Secrets: Use environment variables, never hardcode tokens

Building Locally

docker build -t supabase-mcp-docker .
docker run -e SUPABASE_ACCESS_TOKEN=your_token supabase-mcp-docker

Links

• Supabase MCP Documentation
• Official Supabase MCP Source
• Model Context Protocol
• Docker MCP Registry

License

Apache License 2.0 - See LICENSE file for details.

Contributing

This is a simple Docker wrapper. For contributions to the Supabase MCP Server itself, please visit the official repository.