JinDaGe - Windsurf Supabase MCP Details

article

README

🚀 风帆冲浪（Windsurf）Supabase MCP 服务器

为与 Windsurf 编辑器无缝集成而优化的 Supabase MCP 服务器，基于模型上下文协议标准构建，具备多项关键改进，提升使用体验。

🚀 快速开始

此仓库包含一个经过优化的 Windsurf 版本的 Supabase MCP 服务器，特别增强以实现与 Windsurf Editor 的顺畅协作。它基于模型上下文协议 (MCP) 标准构建，并添加了关键改进，以提升错误处理、响应格式化和 SQL 查询处理的效果。

✨ 主要特性

针对 Windsurf 的主要修改

1. 增强的错误处理

挑战：
- 缺乏结构化的错误响应导致难以调试。
- 流解析错误难以排查。
- 错误信息对 LLM 不够友好。
解决方案：
- 引入包含详细上下文的结构化错误响应。
- 改进错误消息，使其更易于 LLM 理解。
- 添加 SQL 查询结构验证。
- 提升流式错误检测和恢复能力。

2. 响应格式化改进

原始限制：
- 不同响应类型之间 JSON 结构不一致。
- 缺乏用于 UI 组件生成的元数据。
- 类型安全不足。
改进措施：
- 制定统一的 JSON 响应格式标准。
- 添加用于 UI 组件生成的元数据支持。
- 实施严格的 TypeScript 类型系统。
- 支持流式传输复杂的数据结构。

3. SQL 转 REST 增强

支持更复杂的 SQL 操作。
优化查询验证流程。
改善对 JOIN 和子查询的处理。
提升无效 SQL 的错误消息质量。

4. 认证与头信息管理

实现灵活的 API Key 管理策略。
支持使用 bearer token 进行身份验证。
优化 PostgREST 请求的头信息管理。
加强安全验证机制。

与 Windsurf 的集成

此 MCP 服务器专为与 Windsurf Editor 配合设计，提供：

自然语言驱动的数据库交互。
实时查询验证和自动修正。
更适合调试的增强错误消息。
优化的响应格式以支持 UI 组件生成。

💻 使用示例

基础用法

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

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

高级用法

// 此服务器提供两个主要工具：
// 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 });

📦 安装指南

克隆此仓库：

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

安装依赖项：

npm install

配置您的 Supabase 连接：

SUPABASE_URL=your_supabase_url
SUPABASE_KEY=your_supabase_key

🤝 贡献指南

欢迎贡献！请查阅我们的 CONTRIBUTING.md 文件，了解代码规范和提交 Pull Request 的流程。

📄 许可证

此项目采用 MIT 许可证。更多详情，请参阅 LICENSE 文件。

Windsurf Supabase