Supabase MCP 服务器安装指南

本指南将帮助你逐步安装和配置 Supabase MCP 服务器。

目录

1. 先决条件
2. 安装
3. 配置
4. 与 Cursor 集成
5. 验证
6. 问题排查

先决条件

在开始之前，请确保你拥有：

1. 你的系统上安装了 Python 3.12 或更高版本
   • 你可以使用以下命令验证你的 Python 版本：python --version
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=你的项目-ref
SUPABASE_DB_PASSWORD=你的数据库-密码
SUPABASE_REGION=us-east-1
SUPABASE_ACCESS_TOKEN=你的访问-令牌
SUPABASE_SERVICE_ROLE_KEY=你的服务角色-密钥

在哪里找到你的 Supabase 项目信息

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. 添加一个新服务器，使用以下配置：

name: supabase
type: command
command: C:\Users\<用户名>\.local\bin\supabase-mcp-server.exe

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

where.exe supabase-mcp-server

验证

步骤 1：验证安装

打开一个终端并执行：

supabase-mcp-server

如果没有错误，则服务器已正确安装。

步骤 2：在 Cursor 中验证

• 你应该看到服务器旁边有一个绿点
• 可用工具的数量应该是可见的

问题排查

错误: "No tools found"

1. 在 Cursor 的配置中使用可执行文件的完整路径
2. 验证环境变量

访问日志

在 Windows 中，查看日志：

Get-Content "$env:USERPROFILE\.local\share\supabase-mcp\mcp_server.log"

常见的连接问题

1. 验证 SUPABASE_PROJECT_REF 是否正确
2. 确保区域 (SUPABASE_REGION) 与你的项目匹配
3. 确认数据库密码是否正确

支持的区域

• us-west-1: 美国西部（北加利福尼亚）
• us-east-1: 美国东部（北弗吉尼亚）- 默认
• us-east-2: 美国东部（俄亥俄）
• ca-central-1: 加拿大（中部）
• eu-west-1: 欧盟西部（爱尔兰）
• eu-west-2: 欧洲西部（伦敦）
• eu-central-1: 欧盟中部（法兰克福）
• 还有更多...

附加资源

• Supabase MCP 服务器的官方仓库
• Supabase 文档
• Supabase 社区

支持

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

1. 检查服务器日志
2. 验证所有环境变量是否已正确配置
3. 确保你拥有系统所需的权限
4. 查看 GitHub 上的 issues 部分