Supabase MCP

Supabase MCP Sunucusu

Supabase projelerinizi Cursor, Claude, Windsurf ve diğer yapay zeka asistanlarına bağlayın.

Model Context Protocol (MCP), Büyük Dil Modellerinin (LLM'ler) Supabase gibi harici hizmetlerle nasıl konuştuğunu standartlaştırır. Yapay zeka asistanlarını doğrudan Supabase projenize bağlar ve tabloları yönetme, yapılandırmayı getirme ve veri sorgulama gibi görevleri gerçekleştirmelerine olanak tanır. Araçların tam listesine bakın.

Kurulum

1. Güvenlik en iyi uygulamalarımızı izleyin

MCP sunucusunu kurmadan önce, bir LLM'yi Supabase projelerinize bağlamanın risklerini ve bunları nasıl azaltacağınızı anlamak için güvenlik en iyi uygulamalarımızı okumanızı öneririz.

2. MCP istemcinizi yapılandırın

Supabase MCP sunucusunu istemcinizde yapılandırmak için kurulum belgelerimizi ziyaret edin. Ayrıca Supabase kontrol panelindeki MCP bağlantı sekmesini ziyaret ederek projeniz için özel bir MCP URL'si oluşturabilirsiniz.

MCP istemciniz, kurulum sırasında sizi otomatik olarak Supabase'e giriş yapmanızı isteyecektir. Çalışmak istediğiniz projeyi içeren organizasyonu seçtiğinizden emin olun.

Çoğu MCP istemcisi aşağıdaki bilgileri gerektirir:

{ "mcpServers": { "supabase": { "type": "http", "url": "https://mcp.supabase.com/mcp" } }
}

MCP istemcinizi belgelerimizde listelenmiş görmüyorsanız, istemcinizin MCP belgelerini kontrol edin ve yukarıdaki MCP bilgilerini beklenen biçimlerine (json, yaml vb.) kopyalayın.

CLI

Supabase'i Supabase CLI ile yerel olarak çalıştırıyorsanız, MCP sunucusuna http://localhost:54321/mcp adresinden erişebilirsiniz. Şu anda, CLI ortamlarındaki MCP Sunucusu sınırlı bir araç alt kümesi sunar ve OAuth 2.1 içermez.

Kendi kendine barındırılan

Kendi kendine barındırılan Supabase için MCP sunucusunu etkinleştirme sayfasına bakın. Şu anda, kendi kendine barındırılan ortamlardaki MCP Sunucusu sınırlı bir araç alt kümesi sunar ve OAuth 2.1 içermez.

Yapılandırma seçenekleri ve araçlar

Mevcut araçların ve yapılandırma seçeneklerinin tam listesi için Supabase MCP Sunucusu belgelerine bakın.

Belgeler ayrıca sizin için yapılandırma seçeneklerini doldurmak üzere etkileşimli bir URL oluşturucu içerir.

AI SDK'nın MCP İstemcisi ile Kullanım

@supabase/mcp-server-supabase paketi, Vercel AI SDK'nın MCP istemcisi için giriş ve çıkış şemalarını doldurmak üzere createToolSchemas() dışa aktarır. Bu, Supabase MCP araçlarının, istemci tarafı doğrulama ve girişleri ve çıkışları için çıkarılan TypeScript türleriyle statik araçlar olarak ele alınmasına olanak tanır.

import { createToolSchemas } from '@supabase/mcp-server-supabase';
import { createMCPClient } from '@ai-sdk/mcp';
import { streamText } from 'ai'; const mcpClient = await createMCPClient({ transport: { type: 'http', url: 'https://mcp.supabase.com/mcp', },
}); const tools = await mcpClient.tools({ schemas: createToolSchemas(),
}); const result = streamText({ model, tools, prompt: '...' }); for (const step of await result.steps) { for (const toolResult of step.staticToolResults) { if (toolResult.toolName === 'get_project_url') { toolResult.input; // { project_id: string } toolResult.output; // { url: string } } }
}

createToolSchemas(), MCP sunucusunun URL parametrelerine benzer filtreleme seçeneklerini kabul eder:

• features: Belirli özellik gruplarıyla sınırlayın (ör. ['database', 'docs']). Varsayılan olarak tüm varsayılan özellik gruplarına ayarlıdır.
• projectScoped: true olduğunda, project_id öğesini araç giriş şemalarından çıkarır ve hesap düzeyindeki araçları hariç tutar — project_ref ile yapılandırılmış bir sunucuya bağlanırken kullanın. Varsayılan olarak false değerine ayarlıdır.
• readOnly: true olduğunda, değiştiren araçları hariç tutar — read_only=true ile yapılandırılmış bir sunucuya bağlanırken kullanın. Varsayılan olarak false değerine ayarlıdır.

const mcpClient = await createMCPClient({ transport: { type: 'http', url: 'https://mcp.supabase.com/mcp?project_ref=<project-ref>&read_only=true&features=database,docs', },
}); const tools = await mcpClient.tools({ schemas: createToolSchemas({ features: ['database', 'docs'], projectScoped: true, readOnly: true, }),
});

[!NOT]
Bu sunucu, MCP araç sonuçlarında structuredContent göndermez. AI SDK, content metninden JSON ayrıştırmaya geri döner.

Daha fazla bilgi için AI SDK belgelerindeki Şema Tanımı ve Yazılan Araç Çıktıları bölümlerine bakın.

MCP uç noktasını kendi kendine barındırma

@supabase/mcp-server-supabase paketi, araçları kendi uç noktanızdan HTTP üzerinden sunmak için createSupabaseMcpHandler() dışa aktarır. createSupabaseMcpServer() ile aynı SupabaseMcpServerOptions kabul eder, en önemlisi platform.

İşleyici yalnızca mevcut protokol sürümünü konuşur. legacy: 'reject' ile oluşturulur, bu nedenle yalnızca 2025 dönemi protokolünü konuşan bir istemci, hizmet verilmek yerine HTTP 400 alır.

platform istek başına bir kimlik bilgisi taşıdığında, işleyiciyi istek başına oluşturun ve yanıt bittiğinde kapatın. İşleyici, sağladığınız platform üzerinde kapanır, bu nedenle paylaşılan bir işleyici her isteğe o platformla hizmet verir.

platform paylaşılması amaçlandığında, örneğin bir hizmet hesabı belirteci, uzun ömürlü bir işleyici uygundur. Yanıt başına değil, bir kez oluşturun ve kapanışta close() yapın, çünkü close() abonelik yönlendiricisini yok eder ve sonraki istekleri reddeder.

import { createServer } from 'node:http';
import { toNodeHandler } from '@modelcontextprotocol/node';
import { createSupabaseMcpHandler } from '@supabase/mcp-server-supabase';
import { createSupabaseApiPlatform } from '@supabase/mcp-server-supabase/platform/api'; const server = createServer((req, res) => { const accessToken = getAccessTokenFromRequest(req); // your own auth const handler = createSupabaseMcpHandler({ platform: createSupabaseApiPlatform({ accessToken }), }); // `close()` aborts in-flight exchanges, so close on `res` finishing rather // than when the handler resolves, which would cut streaming responses short. res.on('close', () => { handler.close().catch((error) => console.error(error)); }); toNodeHandler(handler)(req, res).catch((error) => console.error(error));
});

toNodeHandler, bu paketin bir bağımlılığı olmayan @modelcontextprotocol/node kaynağından gelir. Yanına kurun.

Diğer MCP sunucuları

@supabase/mcp-server-postgrest

PostgREST MCP sunucusu, kendi kullanıcılarınızı REST API aracılığıyla uygulamanıza bağlamanıza olanak tanır. Proje README'sinde daha fazla ayrıntıya bakın.

Kaynaklar

• Model Context Protocol: MCP ve yetenekleri hakkında daha fazla bilgi edinin.
• Geliştirmeden üretime: Değişiklikleri üretim ortamlarına güvenle nasıl taşıyacağınızı öğrenin.

Geliştiriciler için

Bu projeye nasıl katkıda bulunacağınızla ilgili ayrıntılar için CONTRIBUTING bölümüne bakın.

Lisans

Bu proje Apache 2.0 altında lisanslanmıştır. Ayrıntılar için LISANS dosyasına bakın.