用途
Supabase MCP Skill 是一个技能包，旨在为 AI 编程助手提供通过 Model Context Protocol（MCP）操作 Supabase 的完整指导。当用户需要配置 Supabase MCP 服务器、将 AI 工具连接到 Supabase 项目、调试 MCP 连接问题，或进行数据库架构设计、安全策略实现、迁移管理时，可参考本技能。
主要能力
技能覆盖以下领域：
- 安装与配置：设置或配置 Supabase MCP 服务器（Cursor、Claude Desktop、Claude Code CLI），连接 AI 工具到 Supabase 项目，调试 MCP 连接问题，配置只读模式、项目范围限定或功能组。
- 数据库设计：按最佳实践设计数据库架构，实现表关系（一对多、多对多、多态），在规范化模式（单表 vs 类表继承）之间选择，为多租户或微服务设计，处理时间数据或审计日志。
- 安全与访问控制：实现行级安全（RLS）策略，与 auth.users 集成认证，构建基于角色的访问控制（RBAC），保护多租户应用，防止未授权数据访问。
- 迁移与模式演进：创建和管理数据库迁移，在不破坏兼容性的前提下演进模式，处理向后兼容，使用 Supabase 分支进行测试。
- 生产模式：会话管理与超时逻辑，记忆持久化模式（soul + process 双持久化），基于区域组织的消息存储，带验证的状态管理，错误处理与优雅降级。
- 性能与优化：查询性能的索引策略，使用 EXPLAIN ANALYZE 进行查询优化，连接池配置，读副本设置以扩展。
使用方式
技能提供快速参考示例，包括：
- MCP 服务器设置（Claude Code CLI）：通过
claude mcp add命令安装，支持项目范围限定和只读模式。 - 单例 Supabase 客户端（TypeScript）：使用
@supabase/supabase-js创建服务端单例客户端。 - 带 RLS 的用户资料（SQL）：创建与 auth.users 关联的 profiles 表并启用 RLS。
- 多租户组织与 RLS：organizations 与 org_members 表及 RLS 策略。
- 会话加载或创建模式：加载现有会话或创建新会话。
- 键值存储的 Upsert 模式：使用 onConflict 实现原子 upsert。
- 时间数据模式（历史追踪）：使用 valid_from 和 valid_to 追踪历史。
- 物化视图用于分析：聚合分析数据以加速查询。
- 使用触发器的审计日志：自动审计触发器函数。
- 使用 pg_notify 的事件驱动模式：通过 PostgreSQL NOTIFY 发布事件。
技能还包含参考文件，涵盖 MCP 设置、数据库模式、架构设计、安全、工具参考、官方文档（RLS、迁移）、生产模式、代码示例（客户端、会话管理、记忆存储、RLS 策略）以及 GitHub 仓库资料（README、issues、CHANGELOG、releases、文件结构）。
适用场景
- 初学者：从 MCP 配置开始，以只读模式探索，创建简单用户资料表并练习自然语言查询。
- 中级用户：深入学习 RLS 模式、会话管理、多租户 SaaS 应用、审计日志、时间数据追踪。
- 高级用户：掌握生产模式、双持久化、微服务架构、事件溯源与 CQRS、多区域复制、高可用 MCP 部署、复杂 RLS 策略、百万行表性能优化。
限制
资料未提供该技能的具体收费、价格、平台支持范围或效果保证等信息。部分内容（如数据库分支）标注为实验性。使用时应遵循资料中提到的安全最佳实践，如项目范围限定、只读模式、生产环境手动工具审批等。