Windsurf Supabase

🚀 風帆衝浪（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 });

📦 安裝指南

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

🤝 貢獻指南

歡迎貢獻！請查閱我們的 CONTRIBUTING.md 文件，瞭解代碼規範和提交 Pull Request 的流程。

📄 許可證

此項目採用 MIT 許可證。更多詳情，請參閱 LICENSE 文件。