Windsurf Supabase MCP Server

基本能力

产品定位

Windsurf Supabase MCP Server 是一个专为 Windsurf Editor 优化的 MCP 服务器，旨在与 Supabase 无缝集成，提供自然语言数据库交互和实时查询验证功能。

核心功能

1. 增强的错误处理：
2. 结构化错误响应，包含详细上下文
3. 改进的错误消息，便于 LLM 理解
4. SQL 查询结构验证

5. 增强的流错误检测和恢复

6. 响应格式化：

7. 标准化的 JSON 响应格式
8. 添加了 UI 组件生成的元数据
9. 严格的 TypeScript 类型

10. 支持流式传输复杂数据结构

11. SQL 到 REST 转换：

12. 支持更复杂的 SQL 操作
13. 改进的查询验证
14. 更好的 JOIN 和子查询处理

15. 增强的无效 SQL 错误消息

16. 认证和头部管理：

17. 灵活的 API 密钥管理
18. 支持 bearer token 认证
19. 更好的 PostgREST 请求头部管理
20. 增强的安全验证

适用场景

• 自然语言数据库交互
• 实时查询验证和纠正
• 数据库调试和优化
• UI 组件生成

工具列表

1. postgrestRequest：增强的 PostgREST API 访问工具，用于执行 RESTful 请求。
2. sqlToRest：改进的 SQL 到 REST 转换工具，用于将 SQL 查询转换为 RESTful 请求。

常见问题解答

• 如何解决 SQL 查询错误？：使用增强的错误处理功能，查看结构化错误响应和详细上下文。
• 如何优化查询性能？：利用 SQL 到 REST 转换工具，支持复杂 SQL 操作和查询验证。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm。
2. 确保已配置 Supabase 账户和 API 密钥。

安装教程

1. 克隆仓库：

git clone https://github.com/hertzfelt/windsurf-supabase-mcp.git

1. 安装依赖：

npm install

1. 配置 Supabase 连接：

SUPABASE_URL=your_supabase_url
SUPABASE_KEY=your_supabase_key

调试方式

1. 使用 postgrestRequest 工具测试 RESTful 请求：

const result = await postgrestRequest({
  method: 'GET',
  path: '/users',
});

1. 使用 sqlToRest 工具测试 SQL 到 REST 转换：

const query = 'SELECT * FROM users WHERE age > 18';
const { method, path } = await sqlToRest({ sql: query });

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。