Supabase MCP v0.4.0 发布：项目作用域模式与性能优化

Supabase MCP 是一个为 Supabase 项目提供管理控制平面功能的工具，它通过 CLI 接口与 Supabase 云服务交互，帮助开发者更高效地管理数据库资源。最新发布的 v0.4.0 版本带来了两项重要改进：项目作用域限制功能和数据库查询性能优化。

项目作用域模式：更安全的操作环境

新版本引入了项目作用域模式，允许开发者将服务器操作限制在特定的 Supabase 项目中。这一功能通过新增的 --project-ref CLI 参数实现，使用时需要配合个人访问令牌：

npx -y @supabase/mcp-server-supabase@latest --access-token=<personal-access-token> --project-ref=<project-ref>

这种模式特别适合以下场景：

• 多项目环境下的安全隔离
• 自动化脚本的权限控制
• 团队协作时的资源访问限制

项目作用域模式实际上是在服务器层面增加了一道安全屏障，确保所有操作都仅限于指定的项目，避免了意外操作其他项目资源的风险。

数据库查询优化：排除 TimeScaleDB 内部表

v0.4.0 版本解决了 list_tables 工具调用时可能遇到的性能问题。之前版本会返回包括 TimeScaleDB 内部表在内的所有表信息，这些位于 _timescaledb_internal 模式下的表往往数量庞大，会导致：

1. 响应数据量过大（可能达到 MB 级别）
2. 上下文窗口被快速耗尽
3. 查询效率低下

新版本自动排除了这些内部表，显著提升了查询性能并减少了不必要的数据传输。同时，list_tables 现在要求必须指定 schema 参数，这既修复了无参数传递时的游标问题，也为查询提供了更合理的默认行为（专注于 public 和 auth 模式）。

升级注意事项

本次更新包含一个破坏性变更：list_tables 工具调用现在必须提供 schema 数组参数。开发者需要检查现有代码中对该工具的调用，确保传递了适当的模式参数。

对于使用 TimeScaleDB 扩展的用户，这一变更将显著改善他们的使用体验，不再需要手动过滤内部表，也避免了因大结果集导致的性能问题。

Supabase MCP 通过这些改进继续向着更安全、更高效的工具方向发展，为开发者提供更好的 Supabase 项目管理体验。