Supabase MCP服务器安装与配置指南

Supabase MCP服务器安装与配置指南

supabase-mcp-server Supabase MCP Server to enable Cursor & Windsurf to interact with Supabase directly 项目地址: https://gitcode.com/gh_mirrors/sup/supabase-mcp-server

1. 项目基础介绍

Supabase MCP服务器是一个开源项目，旨在为Supabase数据库提供一个安全、高效的管理平台。它允许开发者在IDE中安全地运行SQL查询、管理模式更改、调用Supabase管理API，并使用Auth Admin SDK。该项目的主要编程语言是Python。

2. 关键技术和框架

• Python: 作为主要的编程语言，用于实现服务器的核心逻辑。
• asyncpg: 用于异步访问PostgreSQL数据库的库。
• Supabase Management API: 用于远程管理Supabase项目。
• Supabase Auth Admin SDK: 用于管理用户和权限。
• 环境变量: 用于配置服务器与Supabase的连接。

3. 安装和配置准备工作

在开始安装前，请确保您的系统满足以下要求：

• Python 3.12或更高版本
• 安装了PostgreSQL（如果运行本地Supabase实例）
• Supabase项目参考ID和数据库密码
• Supabase管理API的访问令牌（如果使用远程项目）
• Supabase Auth Admin SDK的服务角色密钥（如果使用远程项目）
• 从Supabase网站获取的API密钥

详细的安装步骤

步骤 1: 克隆项目仓库

首先，您需要克隆项目仓库到本地机器上：

git clone https://github.com/alexander-zuev/supabase-mcp-server.git
cd supabase-mcp-server

步骤 2: 设置环境变量

根据您的Supabase项目配置环境变量。您可以创建一个.env文件并填入以下内容：

SUPABASE_PROJECT_REF=您的Supabase项目参考ID
SUPABASE_DB_PASSWORD=您的数据库密码
SUPABASE_REGION=us-east-1  # 根据您的项目实际所在区域填写
SUPABASE_ACCESS_TOKEN=您的Supabase管理API访问令牌
SUPABASE_SERVICE_ROLE_KEY=您的Supabase Auth Admin SDK服务角色密钥
QUERY_API_KEY=从thequery.dev获取的API密钥

步骤 3: 安装依赖

使用pip安装项目依赖：

pip install -r requirements.txt

步骤 4: 运行服务器

运行以下命令来启动MCP服务器：

python main.py

步骤 5: 配置IDE

最后，您需要在IDE中配置MCP服务器的连接。具体步骤取决于您使用的IDE，但一般来说，您需要指定服务器的地址和端口，并使用您的Supabase项目的数据库凭据。

现在，您的Supabase MCP服务器已经准备好使用了。您可以开始在IDE中管理您的Supabase项目了。如果在安装或配置过程中遇到任何问题，请查阅项目的README文件或在GitHub上提出问题。

supabase-mcp-server Supabase MCP Server to enable Cursor & Windsurf to interact with Supabase directly 项目地址: https://gitcode.com/gh_mirrors/sup/supabase-mcp-server