Windsurf Supabase MCP 服务器

一个为 Windsurf 优化的 Supabase 集成 MCP 服务器

此仓库包含一个为 Windsurf 优化的 Supabase MCP 服务器版本，专门增强了与 Windsurf 编辑器的无缝协作。它构建于 模型上下文协议 (MCP) 标准之上，并添加了关键改进，以实现更好的错误处理、响应格式化和 SQL 查询处理。

为 Windsurf 做的关键修改

1. 增强的错误处理

我们在原始错误处理系统中面临几个挑战：

• 格式错误的 SQL 查询会导致静默失败
• 流解析错误难以调试
• 错误消息对 LLM 不友好

我们的解决方案：

• 添加了带有详细上下文的结构化错误响应
• 改进了错误消息，以便更好地被 LLM 理解
• 添加了 SQL 查询结构的验证
• 增强了流错误检测和恢复

2. 响应格式化

原始响应格式存在局限性：

• 不同响应类型之间的 JSON 结构不一致
• UI 组件缺少元数据
• 类型安全有限

我们的改进：

• 标准化了 JSON 响应格式
• 添加了用于 UI 组件生成的元数据
• 实现了严格的 TypeScript 类型
• 添加了对流式传输复杂数据结构的支持

3. SQL 到 REST 转换

我们增强了 SQL 到 REST 的转换：

• 添加了对更复杂 SQL 操作的支持
• 改进了查询验证
• 更好地处理 JOIN 和子查询
• 增强了无效 SQL 的错误消息

4. 身份验证 & 标头

身份验证处理方面的关键改进：

• 灵活的 API 密钥管理
• 支持 Bearer Token 身份验证
• 更好地管理 PostgREST 请求的标头
• 增强了安全验证

与 Windsurf 集成

此 MCP 服务器专门设计用于与 Windsurf 编辑器配合使用，提供：

• 通过自然语言实现无缝的数据库交互
• 实时查询验证和更正
• 增强的错误消息，以便更好地进行调试
• 优化的响应格式，用于 UI 组件

在 Windsurf 中的使用示例

// 增强的响应处理示例
const response = await postgrestRequest({
  method: 'GET',
  path: '/todos?is_completed=eq.false',
});

// 响应包括 UI 组件的元数据
const { data, metadata } = response;

安装

1. 克隆此仓库：

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

2. 安装依赖项：

npm install

3. 配置您的 Supabase 连接：

SUPABASE_URL=your_supabase_url
SUPABASE_KEY=your_supabase_key

与 Windsurf 一起使用

此服务器提供两个主要工具：

1. postgrestRequest: 增强的 PostgREST API 访问

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

2. sqlToRest: 改进的 SQL 到 REST 转换

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

贡献

欢迎贡献！请阅读我们的 贡献指南，了解我们的行为准则以及提交 Pull Request 的流程。

许可证

此项目根据 MIT 许可证获得许可。 有关详细信息，请参见 LICENSE 文件。