安装
pipx install supabase-mcp-server适合谁
这份指南给还在用这个社区 Query MCP、并想在 IDE 里安全执行 SQL 或调用 Supabase Management API 的人。官方主路径是 pipx 安装 supabase-mcp-server，以 stdio 接到 Cursor、Windsurf、Cline。作者已声明不再积极维护，并指向官方后继仓库。若你要选长期方案，应先看后继项目，而不是把本仓库当成唯一入口。
后继仓库：
https://github.com/supabase-community/supabase-mcp
它适合先在 read-only 模式跑 SQL 的人。证据写明可控制 read-only / read-write，运行时做 risk level assessment，并对 SQL 分 safe、write、destructive 三档。它不适合一上来就跑 destructive 语句，也不适合把未点名的工具函数名当成已证实接口。
3 分钟完成第一次尝试
官方推荐安装如下。前置条件：本机可运行 pipx。配置位置是支持 stdio 的 MCP 客户端。不要同时把 uv pip install 当成另一条首选安装。
pipx install supabase-mcp-server
本仓库页：
https://github.com/alexander-zuev/supabase-mcp-server
第一次尝试使用官方只读 SQL 能力：把执行模式放在 read-only，跑一条不改数据的查询。成功信号是返回查询结果，而不是被安全策略拦截。只读仍会连接你的 Supabase/Postgres，不能理解成无网络或无库访问。服务器本身用 asyncpg，不再依赖本机 PostgreSQL 开发库；只有你在跑 local Supabase instance 时才仍需要 PostgreSQL。
使用案例
案例一：只读查数。对应 Control read-only ... SQL query execution。证据没有写出工具函数名或示例 SQL，不要编造。成功时能看到结果，并可能带上风险评级。
案例二：改 schema 或调 Management API / Auth Admin SDK。对应 manage schema changes、call the Supabase Management API、use Auth Admin SDK。这是写入：调用前确认处于 write 模式，并看清三档安全里它被标成 safe、write 还是 destructive。成功信号是变更被安全控件接受。没有官方撤销步骤的，不要写成可随便回滚。
使用边界
作者不再积极维护。只读/读写模式与三档安全是内置控件，不是零风险。证据没有给出具体工具名单、密钥变量名或卸载步骤。uv 安装只是文档里的另一条包管理器命令，不要和 pipx 主路径并列。