Supabase MCP：把数据库交给 AI 管

Supabase 官方托管 MCP 端点，一句话就能让 AI 建表、查数据、看配置。

自己的数据库接进 AI 最大的病点是凭据与环境隔离：本地跑一个 server，得把 connection string 塞进环境变量，一不小心就把生产库摸到了。Supabase MCP 走的是托管端点 + OAuth：客户端里填一个 URL，浏览器登录取授权，不用把密码写进配置文件。仓库是 TypeScript，Apache-2.0，约 3000 星（以 GitHub 为准）。

核心能力

1. 表结构与数据：建表、改字段、查行都能做
连上之后，你可以直接说「照这个 JSON 建一张 orders 表，带 user_id 外键和 created_at 默认值」，它会调对应的工具执行 DDL。查询同理：「上周注册但没下单的用户有多少」，它会自己写 SQL 跑。对经常改表结构的小项目，省掉的是开 SQL 编辑器、贴语句、看报错这一串动作。

2. URL 参数就是安全边界
三个参数最关键：project_ref 把连接锁在某个项目上（工具入参里的 project_id 就不需要了），read_only=true 剔掉所有会改数据的工具，features=database,docs 只开部分能力。实际建议：日常问答用只读 + 单项目，只有真要改表时才临时放开。这一个 URL 比写一堆提示词约束靠谱。

3. 安全建议写在官方文档里，不是可选项
README 第一段就要求先读 security best practices 再配，包括连接 LLM 到生产库的风险与缓解方式。这不是官腔：只要工具能写库，一次错误推断就可能删数据。正确做法是拿开发库或分支库练手，生产库只给只读端点。

4. 项目配置与文档也能问
除了数据库，它还能拉项目配置、查官方文档。场景上就是「这个项目的 Auth 回调地址配错了没」「RLS 策略怎么写」这类问题，不用你在 dashboard 里一层层点。开启 docs 能力后，它给的答案会对着当前版本文档，而不是模型记忆里的旧版本。

5. 可以嵌进你自己的应用
包导出 createToolSchemas()，配 Vercel AI SDK 的 MCP client 用，工具入参和返回值都有 TypeScript 类型；createSupabaseMcpHandler() 可以把同一套工具挂到你自己的 HTTP 端点。做内部工具时不用另写一层 agent 封装。

6. 还有面向终端用户的 PostgREST server
@supabase/mcp-server-postgrest 是另一个包，作用是把你自己产品的用户接到他们的数据上（走 REST 接口）。这和内部开发用的 MCP 不是一回事，别搞混：一个是给你自己用，一个是给终端用户用。

使用上手

1. 先读安全文档。了解哪些工具会改数据、如何用只读参数隔离，再开始配。
2. 建或选项目。OAuth 登录时会让你选组织，选错组织就只能看到别人的项目。
3. 写配置。把上面那段 JSON 贴进客户端，客户端会自动拉起登录流程。
4. 加上收窄参数。日常用 https://mcp.supabase.com/mcp?project_ref=<ref>&read_only=true。
5. 先问结构再问数据。第一句让它列出表和字段，确认它看到的是你想操作的那个库。
6. 开发与生产分开配两个 server。开发端点可写、生产端点只读，名字在客户端里写清楚，避免选错。

优点与不足

优点：

• 官方维护，托管端点 + OAuth，不用在本地保存数据库密码。
• URL 参数能直接约束项目与读写权限，安全边界清楚。
• 支持 TypeScript 类型与自托管 handler，适合嵌进自有系统。
• 只读模式一行参数就能开，跑错代价小很多。

不足：

• 托管端点依赖外网与 Supabase 账号，内网环境不好用。
• 本地 CLI 与自托管目前只提供受限工具集，且不支持 OAuth 2.1。
• 工具调用不返回 structuredContent，需要从文本里解析 JSON。
• 误操作的代价很高，必须自己拿环境隔离兜底。

适合谁

• 用 Supabase 做后端、想用 AI 加快建表与查数的开发者。
• 想拿自然语言直接问业务数据的产品与运营。
• 要把 AI 能力接进自有平台的后端工程师。

下载与访问

• 仓库：https://github.com/supabase/mcp
• 官方文档：https://supabase.com/mcp
• 配置入口：https://supabase.com/docs/guides/getting-started/mcp

许可证与获取

本文属于「连接器」分类的 AI 资源专栏，更多评测见分类页。