安裝
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 主路徑並列。