Alexander Zuev Supabase MCP Server

🚀 Supabase MCP 服务器

Supabase MCP 服务器作为连接 Supabase 和开发工具的桥梁，为开发者提供了便捷的开发体验。它支持 Python 方法，具备 SQL 查询验证功能，还能支持本地开发，并且兼容多平台。

Supabase MCP 服务器：连接 Supabase 和开发工具的桥梁

✨ 主要特性

• 支持 Python 方法：提供与原生 Python SDK 相同的功能。
• SQL 查询验证：增强 SQL 查询的安全性和准确性。
• 本地开发支持：集成 Supabase CLI，简化开发流程。
• 多平台兼容性：适用于 macOS、Windows 和 Linux 系统。

📦 安装指南

先决条件

Mac 操作系统

1. 安装 PostgreSQL：

   brew install postgresql
   

2. 启动 PostgreSQL 服务：

   brew services start postgresql
   

Windows 操作系统

1. 下载并安装 PostgreSQL：PostgreSQL 下载页面
2. 安装完成后，启动 PostgreSQL 服务。

项目安装

1. 克隆项目仓库：

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. 使用 uv 包管理器安装依赖项：

   uv sync
   

💻 使用示例

开发服务器启动

基础用法

# 启动开发服务器
mcp dev main.py
# 同时，启动本地 Supabase 实例
supabase start

配置说明

mcp_config.json 示例：

{
  "mcpServers": {
    "supabase": {
      "command": "/Users/az/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/username/cursor/supabase-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "SUPABASE_PROJECT_REF": "127.0.0.1:54322",
        "SUPABASE_DB_PASSWORD": "postgres"
      }
    }
  }
}

📚 详细文档

未来改进计划

• 扩展 Python 支持：增加更多与原生 Python SDK 相同的方法和功能。
• 提升查询验证能力：优化 SQL 查询的语法检查和错误提示。
• 增强文档支持：提供更详细的使用指南和技术文档。