supabase-mcp-installation-guide

supabase-mcp-installation-guide

0

Supabase MCP Server is a guide to install and configure a server that integrates with MCP-compatible clients for streamlined project management, using Supabase as the backend. It features detailed instructions on setting up environment variables and resolving common issues.

Supabase MCP Server Installation Guide

This guide provides a step-by-step process to install and configure the Supabase MCP Server.

Table of Contents

  • Prerequisites
  • Installation
  • Configuration
  • Integration with Cursor
  • Verification
  • Troubleshooting

Prerequisites

  • Python 3.12 or newer
  • MCP-compatible client like Cursor, Windsurf, Cline, or Claude Desktop

Installation

  • Method 1: Using pipx (Recommended)
  • Method 2: Using uv

Configuration

  • Required Environment Variables: SUPABASE_PROJECT_REF, SUPABASE_DB_PASSWORD, SUPABASE_REGION
  • Optional Variables: SUPABASE_ACCESS_TOKEN, SUPABASE_SERVICE_ROLE_KEY

Verification

  • Verify installation and Cursor integration by running the server and checking the status in Cursor.

Troubleshooting

  • Common issues include missing tools and connection problems. Solutions involve checking paths and environment variables.