Windsurf Supabase

🚀 ウィンドサーフ（Windsurf）Supabase MCP サーバー

Windsurfエディタとのシームレスな統合のために最適化されたSupabase MCPサーバー

このリポジトリには、Windsurf版のSupabase MCPサーバーが最適化されたものが含まれています。特に、Windsurf Editorとの円滑な協働を実現するために強化されています。このサーバーは、モデルコンテキストプロトコル (MCP) 標準に基づいて構築され、エラー処理、レスポンスフォーマット、およびSQLクエリ処理の向上のための重要な改良が加えられています。

🚀 クイックスタート

このウィンドサーフ（Windsurf）Supabase MCP サーバーは、Windsurf Editorとのシームレスな統合のために最適化されています。以下の手順でサーバーをセットアップし、Windsurfとの連携を始めましょう。

✨ 主な機能

ウィンドサーフ向けの主な修正点

1. 強化されたエラー処理

我々が直面した課題は以下の通りです。

• 構造化されたエラーレスポンスがないため、デバッグが困難でした。
• ストリーム解析エラーの特定が難しかった。
• エラーメッセージがLLMにとって使いにくかった。

我々の解決策は以下の通りです。

• 詳細なコンテキストを含む構造化されたエラーレスポンスを導入しました。
• エラーメッセージを改善し、LLMが理解しやすいようにしました。
• SQLクエリ構造の検証を追加しました。
• ストリーミングエラーの検出と回復能力を向上させました。

2. レスポンスフォーマットの改善

元のレスポンスフォーマットには以下の制限がありました。

• 異なるレスポンスタイプ間でJSON構造が一貫していなかった。
• UIコンポーネント生成に必要なメタデータが不足していた。
• 型安全性が不十分でした。

我々の改善策は以下の通りです。

• 統一されたJSONレスポンスフォーマット標準を策定しました。
• UIコンポーネント生成のためのメタデータサポートを追加しました。
• 厳格なTypeScript型システムを実装しました。
• 複雑なデータ構造のストリーミングをサポートしました。

3. SQLからRESTへの変換機能の強化

我々はSQLをRESTに変換する機能を向上させました。

• より複雑なSQL操作をサポートするようにしました。
• クエリ検証プロセスを最適化しました。
• JOINとサブクエリの処理を改善しました。
• 無効なSQLのエラーメッセージの品質を向上させました。

4. 認証とヘッダー情報の管理

認証処理に関して、以下の改善を行いました。

• 柔軟なAPIキー管理ポリシーを実装しました。
• bearerトークンによる認証をサポートしました。
• PostgRESTリクエストのヘッダー情報管理を最適化しました。
• セキュリティ検証メカニズムを強化しました。

ウィンドサーフとの統合

このMCPサーバーは、Windsurf Editorと連携するように設計されており、以下の機能を提供します。

• 自然言語によるデータベース操作
• リアルタイムのクエリ検証と自動修正
• デバッグに適した強化されたエラーメッセージ
• UIコンポーネント生成をサポートする最適化されたレスポンスフォーマット

📦 インストール

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

💻 使用例

基本的な使用法

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

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

高度な使用法

このサーバーは2つの主要なツールを提供します。

postgrestRequest：強化版PostgREST APIアクセス

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

sqlToRest：改良されたSQLからRESTへの変換機能

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

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細については、LICENSEファイルを参照してください。

貢献ガイド

貢献を歓迎します！コード規約とPull Requestの提出手順については、CONTRIBUTING.mdファイルを参照してください。