MCP الخادم
تحكم في الواجهة الخلفية Aurabase من Claude Desktop، أو Cursor، أو Windsurf، أو Antigravity، أو Mistral AI، أو VS Code أو أي عميل متوافق مع Model context Protocol - 86 أداة، بدون قيمة مصنعة.
وضع stdio المحلي بشكل افتراضي، وضع HTTP المحلي#
يعرض خادم Aurabase MCP الرسمي 86 أداة لفحص الواجهة الخلفية والتحكم فيها (82 باستخدام مفتاح المشروع). يتم تشغيله على جهازك، في أحد الوضعين:
- وضع stdio (افتراضي): يبدأ عميل MCP الخادم كعملية فرعية باستخدام
npx. - وضع HTTP (HTTP قابل للتدفق): تبدأ خادمًا محليًا واحدًا (
http://127.0.0.1:3001/mcp) وتوجه كل عميل إلى عنوان URL الخاص به.
الخدمة المستضافة (https://mcp.aurabase.dev/mcp، تسجيل الدخول باستخدام OAuth 2.1) تم التخطيط لها، ولم يتم إطلاقها بعد.
تحتوي الحزمة على ثنائيين (aurabase-mcp و aurabase-mcp-hosted)، لذلك يحتاج npx إلى الاسم الثنائي: npx -y -p @aurabase/mcp-server aurabase-mcp. --project-id مطلوب.
npx -y -p @aurabase/mcp-server aurabase-mcp \
--url https://<slug>.aurabase.cloud \
--project-id <uuid> \
--service-role-key aura_sk_…
لبدء تشغيل خادم HTTP المحلي بدلاً من ذلك، قم بإضافة النقل والمنفذ والرمز المميز:
npx -y -p @aurabase/mcp-server aurabase-mcp \
--transport http \
--port 3001 \
--auth-token my_secret_token \
--url http://localhost:8080 \
--project-id <uuid> \
--service-role-key aura_sk_…
التكوين لكل عميل ولكل الوضع#
وضع ستديو (افتراضي)
يستخدم المؤشر (.cursor/mcp.json) وClude Desktop (claude_desktop_config.json) وWindsurf (~/.codeium/windsurf/mcp_config.json) وGoogle Antigravity (~/.gemini/config/mcp_config.json) وVS Code مع Cline أو Roo Code (cline_mcp_settings.json) نفس الكتلة:
{
"mcpServers": {
"aurabase": {
"command": "npx",
"args": ["-y", "-p", "@aurabase/mcp-server", "aurabase-mcp"],
"env": {
"AURABASE_URL": "https://<slug>.aurabase.cloud",
"AURABASE_PROJECT_ID": "<uuid>",
"AURABASE_SERVICE_ROLE_KEY": "aura_sk_…"
}
}
}
}
مقابل مكدس Docker/k3d محلي، اضبط AURABASE_URL على http://localhost:8080.
وضع HTTP (الخادم المحلي)
ابدأ تشغيل خادم HTTP المحلي (انظر أعلاه)، ثم أضف عنوان URL الخاص به وقيمة --auth-token كرمز مميز للحامل.
المؤشر — .cursor/mcp.json أو ~/.cursor/mcp.json:
{
"mcpServers": {
"aurabase": {
"url": "http://127.0.0.1:3001/mcp",
"headers": {
"Authorization": "Bearer my_secret_token"
}
}
}
}
ركوب الأمواج - ~/.codeium/windsurf/mcp_config.json (المفتاح هو serverUrl):
{
"mcpServers": {
"aurabase": {
"serverUrl": "http://127.0.0.1:3001/mcp",
"headers": {
"Authorization": "Bearer my_secret_token"
}
}
}
}
continue.dev (VS Code وJetBrains مع Codestral) — ~/.continue/config.yaml:
models:
- name: Codestral
provider: mistral
model: codestral-latest
apiKey: MISTRAL_API_KEY
mcpServers:
- name: aurabase
url: http://127.0.0.1:3001/mcp
headers:
Authorization: Bearer my_secret_token
تصل Mistral AI (الوكلاء والموصلات) إلى خوادم MCP عبر عنوان URL HTTPS عام: ستستخدم الخدمة المستضافة (https://mcp.aurabase.dev/mcp)، المخطط لها، ولم يتم نشرها بعد.
تقوم الأداة بإرجاع الاستجابة من الواجهة الخلفية، أو خطأ#
أبدا قيمة المصنعة. هذه القاعدة ليست نية: يتم فحصها عند كل تنفيذ لـ CI بواسطة منصة تقوم بتشغيل الخادم مقابل عنوان URL ميت وتفشل إذا استجابت أدنى أداة بنجاح. تعلن كل أداة أيضًا عن مخطط إخراج يتحقق من صحة SDK قبل إرسال الاستجابة.
يقوم وضع القراءة فقط (--read-only) بإزالة أدوات التحويل من الكتالوج ويوجه PostgreSQL لتنفيذ SQL في معاملة للقراءة فقط (37 أداة من 86) - يأتي الضمان من المحرك، وليس فقط من التصفية من جانب العميل.
الأعلام ومتغيرات البيئة#
--url(AURABASE_URL) — Aurabase عنوان URL للمثيل--project-id(AURABASE_PROJECT_ID) — معرف المشروع--service-role-key(AURABASE_SERVICE_ROLE_KEY) — مفتاح المسؤول--read-only(AURABASE_READ_ONLY) — يعرض أدوات القراءة فقط (37 من 86)--allowed-tools(AURABASE_ALLOWED_TOOLS) — القائمة البيضاء، مفصولة بفواصل--destructive-policy(MCP_DESTRUCTIVE_POLICY) — التأكيد التفاعلي لعمليات SQL المدمرة:elicit(افتراضي)،token،deny--state-key(MCP_STATE_KEY) — مفتاح (≥ 32 بايت) يوقع تأكيدات متعددة المنعطفات--transport—stdio(افتراضي) أوhttp--port— منفذ نقل HTTP (الافتراضي 3001)--host— واجهة استماع HTTP (الافتراضية127.0.0.1)--auth-token(AURABASE_MCP_AUTH_TOKEN) — الرمز مطلوب على /mcp - مطلوب في وضع http
وزعت حسب المجال#
82 تم كشفها باستخدام مفتاح مشروع بسيط، 4 محفوظة لخطة الإدارة (مفاتيح API وlist_all_projects - عدم وجود أداة أفضل من الأداة التي تفشل بشكل منهجي بدون هذه القناة).
| قاعدة البيانات (23) | list_tables، description_table، get_performance_advisors، list_extensions، Execute_sql، query_table، Insert_rows، Update_rows،delete_rows، call_rpc، generator_types، diff_schema، Apply_migration، list_migrations، Explore_query، Analysis_table، get_db_size، list_sql_functions، create_sql_function، وظيفة drop_sql، list_sql_trigger، create_sql_trigger، drop_sql_trigger |
|---|---|
| التخزين (9) | list_buckets، get_bucket، create_bucket، list_files،delete_files،move_file، create_signed_url، upload_file،empt_bucket |
| اوث (7) | list_users، get_user، create_user، update_user،delete_user،ban_user، generator_link |
| الإخطارات (10) | send_email، send_push_notification، send_sms، list_notification_logs، get_notification_settings، update_notification_settings، list_notification_templates، create_notification_template،delete_notification_template، get_notification_stats |
| النسخ الاحتياطية (5) | list_backups، create_backup، Restore_backup، get_backup_schedule، set_backup_schedule |
| Edge Functions (6) | استدعاء_وظيفة، قائمة_وظائف، get_function_info، نشر_وظيفة، حذف_وظيفة، set_function_env |
| RLS (6) | list_rls_policies، create_rls_policy، update_rls_policy، drop_rls_policy، toggle_rls، get_security_advisors |
| الذكاء الاصطناعي (5) | فهرس_مستند، rag_query، Vector_search، create_vector_index، ai_completion |
| إمكانية الملاحظة (4) | get_project_metrics، list_slow_queries، list_active_queries، Cancel_query |
| الوقت الحقيقي (3) | list_realtime_channels، get_realtime_settings، update_realtime_settings |
| مشروع (4) | project_info، Switch_project، get_active_project، list_all_projects (قناة الإدارة) |
| مفاتيح واجهة برمجة التطبيقات (3) | create_api_key، list_api_keys، revoc_api_key (قناة الإدارة) |
| التوثيق (1) | search_docs - البحث في الوثائق المضمنة (الإنجليزية) |
تقوم أدوات *_sql_function / *_sql_trigger بإنشاء وظائف PostgreSQL حقيقية ومشغلات مخزنة في مخطط المشروع - لا علاقة لها بـ list_functions / deploy_function (Edge Functions WASM، وقت تشغيل منفصل).
وضع HTTP للعملاء الذين يتصلون عبر عنوان URL#
stdio هو وسيلة النقل الافتراضية. وضع http (بروتوكولات HTTP و MCP القابلة للبث 2025-11-25 و 2026-07-28):
- يستمع إلى
127.0.0.1بشكل افتراضي (--hostلتغييره)؛ - يتطلب رمزًا مميزًا (
--auth-tokenأو رمز حامل) - بدونه، يرفض الخادم البدء؛ - يتحقق من صحة رأس
Originويستجيب 403 لأصل غير مصرح به (حماية ضد CSRF)؛ - مثيل خادم واحد لكل جلسة، مع انتهاء الصلاحية والحد الأقصى القابل للتكوين؛
- يقارن الرموز المميزة في وقت ثابت وحدود حجم الجسم المطلوب.