作者 alexander-zuev · alexander-zuev/supabase-mcp-server
一个社区版 Supabase MCP，具有三层安全措施（safe / write / destructive），自动迁移和 Management + Auth API 覆盖——现已被官方 Supabase MCP 取代。
alexander-zuev/supabase-mcp-server 早于官方 Supabase MCP 推出。它提供丰富的覆盖：SQL（具有风险等级）、自动迁移跟踪、Management API 直通、Auth Admin SDK 操作和 9+ 个 Supabase 服务的日志。维护者已宣布，既然 Supabase 推出了官方 MCP，他们将不再积极维护它——建议考虑迁移。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"supabase-2": {
"command": "uvx",
"args": [
"supabase-mcp-server"
],
"_inferred": true
}
}
}打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。
{
"mcpServers": {
"supabase-2": {
"command": "uvx",
"args": [
"supabase-mcp-server"
],
"_inferred": true
}
}
}Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。
{
"mcpServers": {
"supabase-2": {
"command": "uvx",
"args": [
"supabase-mcp-server"
],
"_inferred": true
}
}
}点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。
{
"mcpServers": {
"supabase-2": {
"command": "uvx",
"args": [
"supabase-mcp-server"
],
"_inferred": true
}
}
}格式与 Claude Desktop 相同。重启 Windsurf 生效。
{
"mcpServers": [
{
"name": "supabase-2",
"command": "uvx",
"args": [
"supabase-mcp-server"
]
}
]
}Continue 使用服务器对象数组，而非映射。
{
"context_servers": {
"supabase-2": {
"command": {
"path": "uvx",
"args": [
"supabase-mcp-server"
]
}
}
}
}加入 context_servers。Zed 保存后热重载。
claude mcp add supabase-2 -- uvx supabase-mcp-server一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。
何时使用： 你想获得使用量/留存数据，而不需要打开 Supabase SQL 编辑器。
结果： 快速获得答案，并有绝对的只读保证。
何时使用： 你需要添加列或索引，并希望作为迁移文件跟踪，而不是即时 ALTER。
plan（text，默认值 'free'）。✓ 已复制结果： 一步完成架构更改和迁移跟踪。
何时使用： 你需要 20 个具有特定元数据的测试账户来演练某个功能。
结果： QA 准备好的账户在一分钟内配置完成。
通过 MCP 生成迁移文件，通过 git MCP 提交
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| execute_sql | query: str, mode: 'safe'|'write'|'destructive' | 任意 SQL 的主要入口，由当前模式限制 | 1 DB query |
| set_mode | mode: 'safe'|'write'|'destructive' | 改变安全等级；默认为 safe | free |
| management_api_request | path, method, body? | 通过 Management API 管理项目设置、扩展、bucket | 1 API call |
| auth_admin_create_user | email, password?, user_metadata? | 为测试或入门配置用户 | 1 Auth call |
| auth_admin_generate_link | user_id, type: 'magiclink'|'recovery' | 为用户生成登录或恢复链接 | 1 Auth call |
| get_logs | service: 'api'|'auth'|'db'|..., since, until | 按服务调试 | 1 API call |
safe 模式为 SELECT；write 为 INSERT/UPDATE；destructive 为全部不要将 Service role key 授予任何可通过不受信任传输访问的东西QUERY_API_KEY 无效在 thequery.dev 重新生成。注意：这是一个包装 Supabase 的单独服务，需要自己注册。
Write 工具在 safe 模式下拒绝执行先调用 set_mode write。完成后记得设置回 safe。
Transaction pool 已耗尽这里仅支持 transaction pooling。减少并发或升级 Supabase 计划。
Supabase dashboard > DB > Connection Pooling| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| 官方 Supabase MCP | 你是新开始——首先使用官方的 | 由 Supabase 维护；此社区版已被其作者弃用 |
| postgres MCP | 你只需要 SQL，不需要 Auth/Management API | 只读、通用；没有 Supabase 特定功能 |
| Neon MCP | 你在 Neon，不是 Supabase | 为安全迁移测试添加 DB 分支 |