🚀 Supabase MCP Server 安装指南

本指南将逐步引导你完成 Supabase MCP Server 的安装与配置，助你快速上手使用该服务。

🚀 快速开始

本指南将帮助你逐步完成 Supabase MCP Server 的安装与配置。

📦 安装指南

先决条件

在开始安装之前，请确保你具备以下条件：

1. 已安装 Python 3.12 或更高版本。
   • 你可以通过在终端运行 python --version 来检查 Python 版本。
2. 拥有兼容的 MCP 客户端：
   • Cursor（推荐）
   • Windsurf
   • Cline
   • Claude Desktop

安装步骤

方法 1：使用 pipx（推荐）

pipx install supabase-mcp-server

方法 2：使用 uv

uv pip install supabase-mcp-server

🔧 配置说明

必要的环境变量

必填项：

• SUPABASE_PROJECT_REF：你的 Supabase 项目 ID
• SUPABASE_DB_PASSWORD：你的数据库密码
• SUPABASE_REGION：托管你项目的 AWS 区域

可选项：

• SUPABASE_ACCESS_TOKEN：用于 API 管理的个人访问令牌
• SUPABASE_SERVICE_ROLE_KEY：Auth Admin SDK 的服务角色密钥

Windows 全局配置

1. 创建配置目录：

mkdir -Force "$env:APPDATA\supabase-mcp"

2. 创建并编辑 .env 文件：

notepad "$env:APPDATA\supabase-mcp\.env"

3. 添加以下配置：

SUPABASE_PROJECT_REF=你的项目 ID
SUPABASE_DB_PASSWORD=你的数据库密码
SUPABASE_REGION=us-east-1
SUPABASE_ACCESS_TOKEN=你的访问令牌
SUPABASE_SERVICE_ROLE_KEY=你的服务角色密钥

项目详细信息获取途径

1. Project Reference：
   • 访问你的 Supabase 项目 URL：https://supabase.com/dashboard/project/<project-ref>
   • project-ref 是 URL 中的标识符。
2. Database Password：
   • 在创建项目时设置。
   • 或者在 Project Settings → Database 中找到。
3. Access Token：
   • 在 https://supabase.com/dashboard/account/tokens 生成。
4. Service Role Key：
   • 在 Project Settings → API → Project API keys 中找到。

💻 使用示例

与 Cursor 的集成

1. 打开 Cursor。
2. 转到 Settings → Features → MCP Servers。
3. 添加一个新的服务器配置如下：

名称：supabase
类型：command
命令：C:\Users\<usuario>\.local\bin\supabase-mcp-server.exe

要找到可执行文件的准确路径：

where.exe supabase-mcp-server

🔍 验证步骤

步骤 1：验证安装

打开终端并运行：

supabase-mcp-server

如果没有任何错误信息，则表示安装成功。

步骤 2：验证配置

检查所有环境变量是否正确设置，并确保服务器正在运行。

🛠️ 故障排除

• 如果服务器启动失败，请查看日志文件以获取更多信息。
• 确保所有环境变量都已正确配置。
• 确认你有系统的必要权限。

📚 相关资源

• Supabase MCP Server 的官方仓库
• Supabase 文档
• Supabase 社区

🆘 支持与反馈

如果在安装过程中遇到问题：

1. 查看服务器日志。
2. 确保所有环境变量都已正确设置。
3. 确认你有系统的必要权限。
4. 咨询 GitHub 问题 部分。