Postgrest MCP

🚀 PostgREST MCP サーバー

OAuth2を使用した完全なPostgREST MCP（Model Context Protocol）サーバーです。任意のPostgRESTサーバーと互換性があります。現在はNEONとSupabaseでのテストが行われています。

Hono を使用して構築され、Streamable HTTPをサポートしています。

🚀 クイックスタート

デプロイオプション

このサーバーは以下の環境にデプロイできます。

• Supabase Edge Functions - デフォルト設定は自動検出されます。
• Cloudflare Workers - 環境変数の設定が必要です。
• Deno Deploy - 環境変数の設定が必要です。

Supabaseにデプロイすると、サーバーは自動的にPostgREST APIエンドポイントと認証設定を検出します。その他のプロバイダー（NEON、カスタムPostgRESTサーバー）の場合は、環境変数を設定する必要があります。

環境変数

AUTH_SERVER_URL

OAuth認可サーバーのURLです。Cloudflare WorkersとDeno Deployのデプロイでは必須です。 Supabase Edge Functionとしてデプロイする場合はオプション - 自動的に利用可能な SUPABASE_URL 環境変数から {origin}/auth/v1 として自動構築されます。 例: https://jdnlvjebzatlybaysdcp.supabase.co/auth/v1

API_BASE_URL

APIリクエストを行うためのPostgRESTサーバーのURLです。 SUPABASE_URL が設定されている場合はオプション - SUPABASE_URL から {origin}/rest/v1 として自動構築されます。この変数を設定すると、自動構築されたURLを上書きできます。 例: https://jdnlvjebzatlybaysdcp.supabase.co/rest/v1

API_KEY

PostgRESTリクエストの apikey ヘッダーに送信されるAPIキーです。 SUPABASE_ANON_KEY と両方が設定されている場合、こちらが優先されます。Supabaseの匿名キーをカスタムAPIキーで上書きするために使用します。 例: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

SUPABASE_ANON_KEY

API_KEY が提供されない場合、PostgRESTリクエストの apikey ヘッダーとして使用されるSupabaseの匿名キーです。 Supabase Edge Functionとしてデプロイすると自動的に利用可能になります。ローカル開発またはSupabase以外のデプロイでは、手動で設定する必要があります。 例: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

✨ 主な機能

Supabase Edge Functions

このサーバーはSupabase OAuth2サーバーからのMCP認証をサポートしています。 環境: Supabase Edge Functionとしてデプロイすると、SUPABASE_URL 環境変数が自動的に利用可能になります。サーバーはこれから AUTH_SERVER_URL を自動構築するので（{origin}/auth/v1 として）、追加の環境設定は必要ありません。

前提条件

Supabase CLIをインストールする必要があります。必要に応じて、依存関係としてインストールします。

# 開発用依存関係としてインストール
pnpm add -D supabase

開発

deno task supabase:dev

MCPエンドポイントは次のURLで利用可能です: http://localhost:54321/functions/v1/postgrest-mcp/mcp

デプロイ

まず、プロジェクトをリンクします（一度だけの設定）。

supabase link --project-ref <your-project-ref>

注: プロジェクトリファレンスはSupabaseダッシュボードのURL https://supabase.com/dashboard/project/<your-project-ref> またはProject Settings > General > Reference ID で確認できます

次に、関数をデプロイします。

deno task supabase:deploy

MCPエンドポイントは次のURLで利用可能です: https://<your-project-ref>.supabase.co/functions/v1/postgrest-mcp/mcp

⚠️ 重要提示 MCPインスペクターはまだRFC 9728に準拠しておらず、WWW-Authenticateヘッダーの resource_metadata パラメータを適切に処理できません。これにより、OAuthメタデータエンドポイントが /functions/v1/postgrest-mcp/.well-known/oauth-protected-resource のような一般的でないパスで提供される場合に問題が発生します。Claude DesktopとClaude Webはこれを正しく処理し、メタデータエンドポイントを正常に検出します。詳細は Inspector issue #576 を参照してください。

Cloudflare Workers

開発

pnpm cloudflare:dev

MCPエンドポイントは次のURLで利用可能です: http://localhost:3000/mcp

デプロイ

pnpm cloudflare:deploy

MCPエンドポイントは次のURLで利用可能です: https://<your-worker>.workers.dev/mcp

Deno

前提条件

Denoをインストールします。

# macOS/Linux
curl -fsSL https://deno.land/install.sh | sh

# Windows
irm https://deno.land/install.ps1 | iex

開発

pnpm deno:dev
# または直接denoで
deno task dev

MCPエンドポイントは次のURLで利用可能です: http://localhost:8000/mcp

デプロイ

まず、新しいプロジェクトを作成します（一度だけの設定）。

deno deploy create --org=<your-org>

次に、デプロイします。

deno task deploy

MCPエンドポイントは次のURLで利用可能です: https://<your-project>.deno.dev/mcp

📄 ライセンス

この実装は supabase-mcp に基づいています。