Install
pipx install supabase-mcp-serverلمن يناسب
هذا الدليل لمن ما زال يستخدم Query MCP المجتمعي هذا ويريد تنفيذ SQL بأمان في IDE أو استدعاء Supabase Management API. المسار الرئيسي الرسمي هو تثبيت supabase-mcp-server عبر pipx ووصله بـ stdio إلى Cursor أو Windsurf أو Cline. صرّح المؤلف أنه لم يعد يصونه بنشاط ويشير إلى المستودع الرسمي اللاحق. إن أردت خيارًا طويل الأمد فانظر اللاحق أولًا؛ لا تعامل هذا المستودع كمدخل وحيد.
المستودع اللاحق:
https://github.com/supabase-community/supabase-mcp
يناسب من يشغّل SQL أولًا في وضع read-only. الدليل يقول إنه يمكن التحكم في read-only / read-write وإجراء risk level assessment وقت التشغيل وتقسيم SQL إلى safe وwrite وdestructive. لا يناسب البدء بجمل destructive، ولا معاملة أسماء دوال أدوات غير مسمّاة كواجهات مثبتة.
إكمال أول محاولة في 3 دقائق
التثبيت الموصى به رسميًا أدناه. الشرط السابق: هذا الجهاز يستطيع تشغيل pipx. موضع الإعداد هو عميل MCP يدعم stdio. لا تعامل uv pip install في الوقت نفسه كتركيب مفضل آخر.
pipx install supabase-mcp-server
صفحة هذا المستودع:
https://github.com/alexander-zuev/supabase-mcp-server
أول محاولة: قدرة SQL الرسمية للقراءة فقط. ضع وضع التنفيذ على read-only وشغّل استعلامًا لا يغيّر البيانات. علامة النجاح عودة نتائج الاستعلام لا اعتراض سياسة الأمان. القراءة فقط تتصل مع ذلك بـ Supabase/Postgres لديك؛ لا تقرأ ذلك بلا شبكة وبلا وصول إلى القاعدة. الخادم نفسه يستخدم asyncpg ولم يعد يعتمد على مكتبات تطوير PostgreSQL المحلية؛ ما زلت تحتاج PostgreSQL فقط إن كنت تشغّل local Supabase instance.
حالات الاستخدام
الحالة 1: استعلام بيانات للقراءة فقط. يقابل ذلك Control read-only ... SQL query execution. الدليل لا يكتب اسم دالة أداة ولا SQL مثالًا؛ لا تخترعهما. عند النجاح ترى نتائج وقد تحمل تقدير مخاطر.
الحالة 2: غيّر schema أو استدعِ Management API / Auth Admin SDK. يقابل ذلك manage schema changes وcall the Supabase Management API وuse Auth Admin SDK. هذه كتابة: قبل الاستدعاء أكّد أنك في وضع write وانظر في الأمان ذي المستويات الثلاثة إن وُسم safe أو write أو destructive. علامة النجاح قبول التغيير من ضوابط الأمان. إن لم توجد خطوات تراجع رسمية فلا تصفه بأنه قابل للإرجاع بسهولة.
حدود الاستخدام
المؤلف لم يعد يصون بنشاط. وضعا القراءة فقط / القراءة-الكتابة والمستويات الثلاثة ضوابط مدمجة وليست انعدام مخاطر. الدليل لا يعطي سجل أدوات ملموسًا ولا أسماء متغيرات أسرار ولا خطوات إزالة. تثبيت uv مجرد أمر مدير حزم آخر في الوثائق؛ لا تضعه بجانب مسار pipx الرئيسي.