⚡ Supabase MCP Server: Connect AI to Your Data
🌟 Overview
Supabase MCP Server is a powerful bridge that allows AI agents (like HuggingChat or Claude) to interact directly with your Supabase database using the Model Context Protocol (MCP). It exposes secure tools for querying, inserting, and managing your data through natural language.
🛠️ Available Tools
query_database: Execute safe SQL queries on your tables.list_tables: Explore your database schema and table structures.insert_record: Add new data to your Supabase tables via AI.get_table_schema: Get detailed column information for a specific table.
🌟 نظرة عامة
Supabase MCP Server هو جسر قوي يسمح لعملاء الذكاء الاصطناعي (مثل HuggingChat أو Claude) بالتفاعل مباشرة مع قاعدة بيانات Supabase الخاصة بك باستخدام بروتوكول Model Context Protocol (MCP). يوفر الخادم أدوات آمنة للاستعلام والإضافة وإدارة بياناتك عبر اللغة الطبيعية.
🛠️ الأدوات المتاحة
query_database: تنفيذ استعلامات SQL آمنة على جداولك.list_tables: استكشاف هيكلية قاعدة البيانات وأسماء الجداول.insert_record: إضافة بيانات جديدة إلى جداول Supabase عبر الذكاء الاصطناعي.get_table_schema: الحصول على معلومات مفصلة عن أعمدة جدول معين.
🚀 How to Connect (Hugging Face MCP) | طريقة الربط التفصيلية
To add this server to your Hugging Face MCP interface, follow these precise steps:
1. Access Settings | الدخول للإعدادات
Go to your Hugging Face account settings and navigate to the MCP Servers section (as shown in your screenshot).
2. Add Custom Server | إضافة خادم مخصص
Click on "Add your first server" or "Add custom server".
3. Configuration Details | تفاصيل الإعداد
Fill in the following fields:
- Server Name:
Supabase-MCP - URL:
https://huggingface.co/AbdulElahGwaith/supabase-mcp - Method:
GET(or as specified by the interface)
4. Authentication Headers | رؤوس المصادقة (هام جداً)
You MUST add the following HTTP Headers to allow the AI to access your database securely:
x-supabase-url: Your Supabase Project URL (e.g.,https://xyz.supabase.co)x-supabase-key: Your Supabase Service Role Key (Secret)
⚠️ Security Note: Never share your Service Role Key publicly. The MCP interface handles these headers securely.
📂 Project Structure | هيكلية المشروع
supabase-mcp/
├── src/
│ ├── server.ts # MCP Server implementation
│ ├── tools.ts # Definition of Supabase tools
│ └── supabase.ts # Supabase client configuration
├── package.json # Project dependencies
└── tsconfig.json # TypeScript configuration
📄 License | الترخيص
This project is licensed under the MIT License.