Supabase MCP Server
2025.04.18
1205
TypeScriptAI 助手集成数据库管理开发辅助开发效率数据库
Supabase MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，用于将 Supabase 项目与 Cursor、Claude、Windsurf 等 AI 助手连接起来。它标准化了大型语言模型（LLMs）与外部服务（如 Supabase）的交互方式，允许 AI 助手直接管理 Supabase 项目中的表、获取配置和查询数据。
View on GitHub
Overview
基本能力
产品定位
Supabase MCP Server 是一个连接 Supabase 项目与 AI 助手的中间件服务，旨在通过标准化协议（MCP）实现 AI 助手对 Supabase 项目的直接管理和操作。
核心功能
- 项目管理：包括创建、暂停、恢复项目，以及获取项目详情和组织信息。
- 数据库操作：支持表、扩展、迁移的列表查询，执行 SQL 语句和应用迁移。
- 项目配置：获取项目 URL 和匿名 API 密钥。
- 分支管理（实验性）：支持开发分支的创建、列表、删除、合并、重置和变基操作。
- 开发工具：生成基于数据库模式的 TypeScript 类型。
- 成本确认：获取和确认新项目或分支的成本。
适用场景
- AI 助手辅助开发：通过 AI 助手直接管理 Supabase 项目，提高开发效率。
- 数据库操作自动化：自动执行 SQL 查询和迁移，减少手动操作。
- 项目监控和调试：获取项目日志，辅助调试和性能监控。
工具列表
- 项目管理工具：
list_projects,get_project,create_project,pause_project,restore_project,list_organizations,get_organization - 数据库操作工具：
list_tables,list_extensions,list_migrations,apply_migration,execute_sql,get_logs - 项目配置工具：
get_project_url,get_anon_key - 分支管理工具：
create_branch,list_branches,delete_branch,merge_branch,reset_branch,rebase_branch - 开发工具：
generate_typescript_types - 成本确认工具：
get_cost,confirm_cost
常见问题解答
- 如何安装 Node.js：从 nodejs.org 下载并安装。
- 如何获取个人访问令牌：在 Supabase 设置的 令牌页面 创建。
- Windows 用户注意事项：需要在命令前添加
cmd /c或wsl前缀。
使用教程
使用依赖
确保已安装 Node.js，可以通过以下命令检查：
node -v
安装教程
- 获取个人访问令牌：在 Supabase 设置的令牌页面创建并复制令牌。
- 配置 MCP 客户端：将以下 JSON 配置添加到 MCP 客户端配置中，替换
<personal-access-token>为你的令牌：
{
"mcpServers": {
"supabase": {
"command": "npx",
"args": [
"-y",
"@supabase/mcp-server-supabase@latest",
"--access-token",
"<personal-access-token>"
]
}
}
}
- Windows 用户：在命令前添加
cmd /c或wsl前缀。
调试方式
- 检查 Node.js 路径：
npm config get prefix
- 添加路径到环境变量：
setx PATH "%PATH%;<path-to-dir>"
- 重启 MCP 客户端。