/ الدليل / الملعب / supabase-mcp-server
← كل الخوادم ↗ GitHub
● مجتمع alexander-zuev ⚡ فوري

supabase-mcp-server

بواسطة alexander-zuev · alexander-zuev/supabase-mcp-server

مشروع Supabase MCP مجتمعي يوفر ثلاث مستويات من الأمان (آمن/كتابة/مدمّر)، والهجرات التلقائية، وتغطية كاملة لـ Management و Auth API — لكنه تم استبداله الآن بـ Supabase MCP الرسمي.

alexander-zuev/supabase-mcp-server يسبق Supabase MCP الرسمي. يوفر تغطية شاملة: SQL (مع مستويات مخاطر)، وتتبع الهجرات التلقائي، وممر Management API، وعمليات Auth Admin SDK، والسجلات عبر 9+ خدمات Supabase. أعلن المحافظ أنه لن يحافظ عليه بنشاط الآن بعد إطلاق Supabase لأداة MCP رسمية — يُنصح بدراسة الهجرة.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

supabase-2.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "supabase-2": {
      "command": "uvx",
      "args": [
        "supabase-mcp-server"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "supabase-2": {
      "command": "uvx",
      "args": [
        "supabase-mcp-server"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "supabase-2": {
      "command": "uvx",
      "args": [
        "supabase-mcp-server"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "supabase-2": {
      "command": "uvx",
      "args": [
        "supabase-mcp-server"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "supabase-2",
      "command": "uvx",
      "args": [
        "supabase-mcp-server"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "supabase-2": {
      "command": {
        "path": "uvx",
        "args": [
          "supabase-mcp-server"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add supabase-2 -- uvx supabase-mcp-server

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: supabase-mcp-server

اسأل عن بيانات تطبيقك في Supabase

👤 المؤسسون والمديرون في التطبيقات المدعومة بـ Supabase ⏱ ~10 min beginner

متى تستخدمه: تريد أرقام الاستخدام والاحتفاظ بدون فتح محرر SQL في Supabase.

المتطلبات الأساسية
  • QUERY_API_KEY (مجاني من thequery.dev) — سجل، انسخ المفتاح
  • SUPABASE_PROJECT_REF + كلمة مرور قاعدة البيانات — لوحة معلومات Supabase > إعدادات المشروع
الخطوات
  1. ابقَ في الوضع الآمن
    عيّن الوضع على آمن. كم عدد المستخدمين الذين سجلوا الدخول الأسبوع الماضي؟✓ تم النسخ
    → نتيجة للقراءة فقط؛ لا توجد طفرة ممكنة
  2. حفر أعمق
    من بينهم، كم عددًا أكمل الإعداد الأولي (لديه أي صف في الملفات الشخصية)؟✓ تم النسخ
    → رقم على غرار الاحتفاظ

النتيجة: إجابات سريعة مع ضمان قراءة فقط حقيقي.

المزالق
  • التبديل إلى وضع الكتابة لـ 'هذا الاستعلام فقط' والنسيان للتبديل مرة أخرى — قل لـ Claude بوضوح: 'العودة إلى الوضع الآمن بعد هذا الاستعلام.'

قم بعمل تغيير المخطط وتتبعه كهجرة حقيقية

👤 المطورون على Supabase ⏱ ~15 min intermediate

متى تستخدمه: تحتاج إلى إضافة عمود أو فهرس وتريد التقاط التغيير كملف هجرة، وليس كـ ALTER عفوي.

المتطلبات الأساسية
  • SUPABASE_ACCESS_TOKEN للـ Management API — لوحة المعلومات > الحساب > الرموز المميزة للدخول
الخطوات
  1. التبديل إلى وضع الكتابة
    عيّن الوضع على الكتابة. أضف العمود plan (نص، الافتراضي 'مجاني') إلى جدول المستخدمين.✓ تم النسخ
    → ALTER تم تنفيذه؛ تم إنشاء ملف الهجرة
  2. المراجعة والالتزام
    اعرض ملف الهجرة المُنشأ. سأقوم بالالتزام به لمستودعنا.✓ تم النسخ
    → مسار ملف SQL + المحتويات

النتيجة: تغيير المخطط + الهجرة المتتبعة في خطوة واحدة.

المزالق
  • تضارب الهجرة مع CI عندما يجري أعضاء الفريق أيضًا تغييرات — التنسيق عبر فرع لكل هجرة؛ لا تفعل هذا في الفرع الرئيسي خلال ساعات عمل الفريق
اجمعها مع: github

توفير مستخدمي الاختبار للتطوير/التدريج عبر Auth Admin SDK

👤 مهندسو الضمان والمطورون ⏱ ~10 min intermediate

متى تستخدمه: تحتاج إلى 20 حسابًا للاختبار مع بيانات محددة لممارسة الميزة.

المتطلبات الأساسية
  • SUPABASE_SERVICE_ROLE_KEY — لوحة المعلومات > إعدادات API (احتفظ بسرية!)
الخطوات
  1. إنشاء مستخدمين بكميات كبيرة
    إنشاء 20 مستخدم اختبار: [email protected] عبر [email protected]، كلمة المرور 'Test12345!'، مع بيانات وصفية {role: 'qa', plan: 'free'}.✓ تم النسخ
    → 20 معرف UUID للمستخدم تم إرجاعه
  2. إنشاء روابط الدخول السحري
    لكل واحد، قم بإنشاء رابط دخول سحري وحفظه في /tmp/qa-users.tsv.✓ تم النسخ
    → TSV مع البريد الإلكتروني + الرابط

النتيجة: حسابات جاهزة للضمان موفرة في أقل من دقيقة.

المزالق
  • مفتاح الدور الخدمة هو وضع الله — لا تضعه أبدًا في سياق الطلب أمام المستخدم — احتفظ بـ env var؛ لا تطبع أبدًا
اجمعها مع: filesystem

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

supabase-2 + github

توليد ملف الهجرة عبر MCP، الالتزام عبر git MCP

أضف عمودًا عبر وضع الكتابة، ثم التزم بملف الهجرة المُنشأ برسالة 'feat: add users.plan'.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
execute_sql query: str, mode: 'safe'|'write'|'destructive' المدخل الرئيسي للـ SQL التعسفي، مبوابة بالوضع الحالي 1 DB query
set_mode mode: 'safe'|'write'|'destructive' تغيير مستوى الأمان؛ الافتراضي هو آمن free
management_api_request path, method, body? إدارة إعدادات المشروع والملحقات والدلاء عبر Management API 1 API call
auth_admin_create_user email, password?, user_metadata? توفير المستخدمين للاختبار أو الإعداد الأولي 1 Auth call
auth_admin_generate_link user_id, type: 'magiclink'|'recovery' احصل على عنوان URL للدخول أو الاسترجاع للمستخدم 1 Auth call
get_logs service: 'api'|'auth'|'db'|..., since, until إصلاح الأخطاء حسب الخدمة 1 API call

التكلفة والحدود

تكلفة التشغيل

حصة API
يحدها خطة Supabase (اتصالات قاعدة البيانات، حدود معدل Management API)
الرموز لكل استدعاء
نتائج SQL: تعتمد على LIMIT؛ دائمًا حد أقصى
التكلفة المالية
مجاني (Apache 2.0). تكاليف Supabase هي فاتورتك الحالية.
نصيحة
ابقَ في الوضع الآمن بشكل افتراضي. فقط قم بالتصعيد عندما تقصد صراحة الطفرة.

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: SELECT للوضع الآمن؛ INSERT/UPDATE للكتابة؛ الكل للمدمّر
تخزين بيانات الاعتماد: متغيرات البيئة. مفتاح الدور الخدمة حساس بشكل خاص.
نقل البيانات الخارجي: تذهب الاستعلامات إلى مشروع Supabase الخاص بك؛ يرى النموذج اللغوي صفوف النتيجة
لا تمنح أبدًا: مفتاح الدور الخدمة لأي شيء يمكن الوصول إليه عبر نقل غير موثوق

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

QUERY_API_KEY invalid

أعد إنشاء thequery.dev. ملاحظة: هذه خدمة منفصلة تلف Supabase وتتطلب اشتراك خاص بها.

Write tool refuses in safe mode

استدعِ set_mode write أولاً. تذكر أن تعيد التعيين إلى وضع آمن عند الانتهاء.

Transaction pool exhausted

فقط دعم تجميع المعاملات هنا. قلل التزامن أو قم بترقية خطة Supabase.

تحقق: لوحة معلومات Supabase > قاعدة البيانات > Connection Pooling

البدائل

supabase-mcp-server مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Supabase MCP الرسميتبدأ من جديد — استخدم الرسمي أولاًتحتفظ بها Supabase؛ هذا المشروع المجتمعي تم إهمالها من قبل مؤلفها
postgres MCPتحتاج فقط SQL، وليس Auth/Management APIsقراءة فقط، عام؛ بدون ميزات خاصة بـ Supabase
Neon MCPأنت على Neon، وليس Supabaseيضيف فروع قاعدة البيانات لاختبار هجرة آمنة

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills