Postgrest MCP

🚀 PostgREST MCP 服務器

這是一個完整的 PostgREST MCP（模型上下文協議）服務器，它使用 OAuth2 進行身份驗證，可與任何 PostgREST 服務器配合使用。目前已在 NEON 和 Supabase 上進行了測試。

該服務器基於 Hono 構建，並支持流式 HTTP。

🚀 快速開始

本服務器可部署到以下平臺：

• Supabase 邊緣函數 - 默認配置會自動檢測
• Cloudflare Workers - 需要配置環境變量
• Deno Deploy - 需要配置環境變量

當部署到 Supabase 時，服務器會自動檢測 PostgREST API 端點和身份驗證配置。對於其他提供商（NEON、自定義 PostgREST 服務器），則需要配置環境變量。

📦 安裝指南

環境變量

AUTH_SERVER_URL

OAuth 授權服務器的 URL。對於 Cloudflare Workers 和 Deno Deploy 部署，此變量是必需的。 當作為 Supabase 邊緣函數部署時可選 - 會根據自動可用的 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 密鑰。 當同時設置了 API_KEY 和 SUPABASE_ANON_KEY 時，API_KEY 優先。使用此變量可使用自定義 API 密鑰覆蓋 Supabase 匿名密鑰。 示例：eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

SUPABASE_ANON_KEY

當未提供 API_KEY 時，用作 PostgREST 請求的 apikey 標頭的 Supabase 匿名密鑰。 作為 Supabase 邊緣函數部署時會自動可用。對於本地開發或非 Supabase 部署，需要手動設置此變量。 示例：eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

💻 使用示例

Supabase 邊緣函數

本服務器支持來自 Supabase OAuth2 服務器的 MCP 身份驗證。 環境：當作為 Supabase 邊緣函數部署時，SUPABASE_URL 環境變量會自動可用。服務器會根據它自動構建 AUTH_SERVER_URL（即 {origin}/auth/v1），因此無需額外的環境配置。

前提條件

需要安裝 Supabase CLI。如有需要，可作為依賴項進行安裝：

# 作為開發依賴安裝
pnpm add -D supabase

開發

deno task supabase:dev

MCP 端點將在以下地址可用：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> 或在項目設置 > 常規 > 參考 ID 中查找

然後部署函數：

deno task supabase:deploy

MCP 端點將在以下地址可用：https://<your-project-ref>.supabase.co/functions/v1/postgrest-mcp/mcp

⚠️ 重要提示 MCP 檢查器（截至 2026 年 1 月）尚未符合 RFC 9728，並且無法正確處理 WWW-Authenticate 標頭中的 resource_metadata 參數。當 OAuth 元數據端點位於不常見的路徑（如 /functions/v1/postgrest-mcp/.well-known/oauth-protected-resource）時，會出現問題。Claude Desktop 和 Claude Web 可以正確處理此問題，並能成功發現元數據端點。詳情請參閱 檢查器問題 #576。

Cloudflare Workers

開發

pnpm cloudflare:dev

MCP 端點將在以下地址可用：http://localhost:3000/mcp

部署

pnpm cloudflare:deploy

MCP 端點將在以下地址可用：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 端點將在以下地址可用：http://localhost:8000/mcp

部署

首先，創建一個新項目（一次性設置）：

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

然後進行部署：

deno task deploy

MCP 端點將在以下地址可用：https://<your-project>.deno.dev/mcp

📄 許可證

本實現基於 supabase-mcp。