使用说明

项目简介

Supabase MCP Server 是一个功能丰富的 MCP 服务器，它允许 MCP 客户端（如 Cursor、Windsurf、Claude Desktop、Cline 等）安全地与 Supabase 数据库交互。它提供了一系列工具，用于数据库管理、SQL 查询执行、Supabase Management API 访问以及用户身份验证管理，并内置了安全控制机制。

主要功能点

• 兼容 Cursor、Windsurf、Cline 等 MCP 客户端，支持 stdio 协议。
• 安全执行 SQL 查询，区分只读和读写模式，并进行风险评估。
• 三层安全系统：安全、写入和破坏性操作控制。
• 数据库 schema 变更的自动版本控制。
• Supabase Management API 和 Auth Admin SDK 的安全访问工具。
• 易于安装和配置，支持多种配置方式。

安装步骤

1. 确保已安装 Python 3.12+。
2. 使用 pipx 或 uv 等包管理器安装：

   pipx install supabase-mcp-server
   # 或
   uv pip install supabase-mcp-server
   

服务器配置

MCP客户端需要配置MCP服务器的启动命令才能连接。以下是针对不同MCP客户端的配置示例 (JSON 格式，无需修改，复制到客户端配置即可):

• Cursor 配置:

  {
    "name": "supabase",
    "type": "command",
    "command": "/full/path/to/supabase-mcp-server"  // 替换为 supabase-mcp-server 的完整路径，可以使用 'which supabase-mcp-server' 或 'where supabase-mcp-server' 命令查找
  }
  

• Windsurf 配置:

  {
    "mcpServers": {
      "supabase": {
        "command": "/full/path/to/supabase-mcp-server",  // 替换为 supabase-mcp-server 的完整路径
        "env": {
          "SUPABASE_PROJECT_REF": "your-project-ref",    // 您的 Supabase 项目引用 ID
          "SUPABASE_DB_PASSWORD": "your-db-password",     // 您的数据库密码
          "SUPABASE_REGION": "us-east-1"                 // (可选) Supabase 项目所在区域，默认为 us-east-1
        }
      }
    }
  }
  

• Claude Desktop 配置:

  {
    "mcpServers": {
      "supabase": {
        "command": "/full/path/to/supabase-mcp-server",  // 替换为 supabase-mcp-server 的完整路径
        "env": {
          "SUPABASE_PROJECT_REF": "your-project-ref",    // 您的 Supabase 项目引用 ID
          "SUPABASE_DB_PASSWORD": "your-db-password",     // 您的数据库密码
          "SUPABASE_REGION": "us-east-1"                 // (可选) Supabase 项目所在区域，默认为 us-east-1
        }
      }
    }
  }
  

• Cline 配置:

  {
    "mcpServers": {
      "supabase": {
        "command": "/full/path/to/supabase-mcp-server",  // 替换为 supabase-mcp-server 的完整路径
        "env": {
          "SUPABASE_PROJECT_REF": "your-project-ref",    // 您的 Supabase 项目引用 ID
          "SUPABASE_DB_PASSWORD": "your-db-password",     // 您的数据库密码
          "SUPABASE_REGION": "us-east-1"                 // (可选) Supabase 项目所在区域，默认为 us-east-1
        }
      }
    }
  }
  

基本使用方法

1. 安装并配置 Supabase MCP Server。
2. 在 MCP 客户端中配置并连接到 Supabase MCP Server。
3. 使用客户端提供的界面或命令，通过 MCP Server 提供的工具与 Supabase 数据库进行交互，例如执行 SQL 查询、管理数据库 schema、调用 Supabase Management API 等。