Advertise
MCP.so
Sign In

Supabase MCP Server

@MCP-Mirror

Repository

Basic information

Category

Cloud & Infrastructure

Transports

stdio

Author

MCP-Mirror

About Supabase MCP Server

Mirror of

#supabase#mcp-server#database-management

Supabase MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "alexander-zuev_supabase-mcp-server": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Supabase MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Supabase MCP Server?

Supabase MCP Server is an MCP (Model Context Protocol) implementation that enables Cursor and Windsurf IDEs to interact directly with a Supabase PostgreSQL database. It provides a set of database management tools, including schema exploration and SQL query validation, designed for developers using these AI‑assisted IDEs.

How to use Supabase MCP Server?

Clone the repository, create a virtual environment with uv venv, install dependencies with uv sync, then configure the IDE to run the server via uv --directory <path> run main.py. For local development the server connects to 127.0.0.1:54322 with password postgres. For production projects set environment variables SUPABASE_PROJECT_REF and SUPABASE_DB_PASSWORD.

Key features of Supabase MCP Server

  • Works with both Windsurf and Cursor IDEs.
  • Supports local Supabase projects and production Supabase projects.
  • Built-in database exploration tools with schema insights.
  • Secure read-only database access.
  • SQL query validation.
  • Python 3.12+, PostgreSQL 16+, and uv package manager required.

Use cases of Supabase MCP Server

  • Explore database schemas and tables from within Cursor or Windsurf without leaving the editor.
  • Run validated SQL queries against a production Supabase database in a read‑only mode.
  • Debug or inspect local Supabase PostgreSQL databases during development.
  • Enable AI assistants to understand and interact with the database structure securely.

Frequently asked questions

1

What prerequisites are needed to run the server?

Python 3.12+, PostgreSQL 16+, and the `uv` package manager are required. On macOS, PostgreSQL must be installed before installing dependencies for the `psycopg2` package.

2

Does the server support production Supabase databases?

Yes. Set the environment variables `SUPABASE_PROJECT_REF` and `SUPABASE_DB_PASSWORD` to connect to staging or production Supabase projects. The server remains read‑only.

3

Is database access read‑only?

Yes. The server enforces read‑only access to the PostgreSQL database. SQL queries are validated before execution.

4

How do I configure the server for Cursor or Windsurf?

For Cursor, add an MCP server entry with `command: uv --directory /path/to/repo run main.py` and the stdio transport. For Windsurf, edit `mcp_config.json` to specify the `uv` command, repository path, and environment variables for connection details.

5

What are the default connection settings for local development?

The server defaults to host `127.0.0.1:54322` with password `postgres`. These can be overridden for production by setting the environment variables.

Comments

More Cloud & Infrastructure MCP servers

L

Lium - GPU cloud

Lium

Find, price and rent GPUs on Lium from Claude, ChatGPT, Codex or any MCP client. Search live GPU availability and prices (H100, H200, B200, RTX 4090 and more), estimate provider earnings, and with Sign in with Lium or a

Backblaze B2 MCP server

backblaze-labs

MCP server for Backblaze B2 Cloud Storage: a focused, safe 40-tool surface (17 native B2 SDK, 19 S3 data-plane, 4 analytics) for any MCP-compatible AI client, currently incubating in Backblaze-Labs

2

Query | MCP server for Supabase

alexander-zuev

Query MCP enables end-to-end management of Supabase via chat interface: read & write query executions, management API support, automatic migration versioning, access to logs and much more.

828

Cloudflare MCP Server

cloudflare

3.9K

Aws Kb Retrieval Server

modelcontextprotocol

Model Context Protocol Servers

88.2K
Advertise