Windsurf Supabase MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides enhanced database interactions through Supabase, including SQL query processing, PostgREST API access, SQL to REST conversion, and optimized response formatting for UI components, with improved error handling and authentication.

  • Implements strict TypeScript types for response handling, providing type safety for database interactions and standardized JSON response formats.

Windsurf Supabase MCP サーバー

Supabase統合のためのWindsurfに最適化されたMCPサーバー

このリポジトリには、Windsurf エディタとシームレスに連携するように特別に強化された、Windsurf 向けに最適化された Supabase MCP サーバーが含まれています。Model Context Protocol (MCP) 標準に基づいて構築されており、エラー処理、レスポンスのフォーマット、SQL クエリ処理など、重要な改善が加えられています。

ウィンドサーフィンの主な変更点

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

元のエラー処理システムでは、いくつかの課題に直面しました。

  • 不正なSQLクエリはサイレントエラーを引き起こす
  • ストリーム解析エラーのデバッグが困難でした
  • エラーメッセージはLLMに適していませんでした

当社のソリューション:

  • 詳細なコンテキストを含む構造化されたエラー応答を追加しました
  • LLM の理解を深めるためのエラー メッセージの改善
  • SQLクエリ構造の検証を追加しました
  • 強化されたストリームエラー検出と回復

2. 回答のフォーマット

元の応答形式には制限がありました。

  • 異なるレスポンスタイプ間で一貫性のないJSON構造
  • UIコンポーネントのメタデータが見つかりません
  • 限定型安全性

改善点:

  • 標準化されたJSONレスポンス形式
  • UIコンポーネント生成用のメタデータを追加しました
  • 厳密なTypeScript型を実装
  • 複雑なデータ構造のストリーミングのサポートを追加

3. SQLからRESTへの変換

SQL から REST への変換を強化しました。

  • より複雑なSQL操作のサポートを追加
  • クエリ検証の改善
  • JOINとサブクエリのより優れた処理
  • 無効なSQLに対するエラーメッセージの強化

4. 認証とヘッダー

認証処理における主な改善点:

  • 柔軟なAPIキー管理
  • ベアラートークン認証のサポート
  • PostgRESTリクエストのヘッダー管理の改善
  • 強化されたセキュリティ検証

Windsurfとの統合

この MCP サーバーは、Windsurf エディターと連携するように特別に設計されており、次の機能を提供します。

  • 自然言語によるシームレスなデータベースインタラクション
  • リアルタイムのクエリ検証と修正
  • デバッグを向上させるためのエラーメッセージの強化
  • UIコンポーネントの応答フォーマットを最適化

ウィンドサーフィンでの使用例

// Example of enhanced response handling const response = await postgrestRequest({ method: 'GET', path: '/todos?is_completed=eq.false', }); // Response includes metadata for UI components const { data, metadata } = response;

インストール

  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

ウィンドサーフィンでの使用

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

  1. postgrestRequest : 拡張されたPostgREST APIアクセス
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ライセンスの下で提供されています。詳細はLICENSEファイルをご覧ください。

-
security - not tested
A
license - permissive license
-
quality - not tested

Supabase と Windsurf エディターを統合するために最適化されたモデル コンテキスト プロトコル サーバー。強化されたエラー処理と応答フォーマットにより、自然言語によるデータベース操作を提供します。

  1. Key Modifications for Windsurf
    1. 1. Enhanced Error Handling
    2. 2. Response Formatting
    3. 3. SQL to REST Conversion
    4. 4. Authentication & Headers
  2. Integration with Windsurf
    1. Example Usage in Windsurf
  3. Installation
    1. Usage with Windsurf
      1. Contributing
        1. License
          ID: jvt7hbms24