انتقل إلى المحتوى
شعار أوراباسي
aurabase

MCP الخادم

تحكم في الواجهة الخلفية Aurabase من Claude Desktop، أو Cursor، أو Windsurf، أو Antigravity، أو Mistral AI، أو VS Code أو أي عميل متوافق مع Model context Protocol - 86 أداة، بدون قيمة مصنعة.

المرجع7 د قراءةالمستوى مرجعتمت المراجعة في 18‏/10‏/2026

لقد تغير المصدر الإنجليزي منذ هذه الترجمة. قد تكون بعض المعلومات قديمة.
تمت ترجمة هذه الصفحة تلقائيًا. النسخة الإنجليزية موثوقة.

وضع stdio المحلي بشكل افتراضي، وضع HTTP المحلي#

يعرض خادم Aurabase MCP الرسمي 86 أداة لفحص الواجهة الخلفية والتحكم فيها (82 باستخدام مفتاح المشروع). يتم تشغيله على جهازك، في أحد الوضعين:

  1. وضع stdio (افتراضي): يبدأ عميل MCP الخادم كعملية فرعية باستخدام npx.
  2. وضع 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 مطلوب.

terminalbash
npx -y -p @aurabase/mcp-server aurabase-mcp \
  --url https://<slug>.aurabase.cloud \
  --project-id <uuid> \
  --service-role-key aura_sk_…

لبدء تشغيل خادم HTTP المحلي بدلاً من ذلك، قم بإضافة النقل والمنفذ والرمز المميز:

terminalbash
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) نفس الكتلة:

mcp_config.jsonjson
{
  "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:

.cursor/mcp.jsonjson
{
  "mcpServers": {
    "aurabase": {
      "url": "http://127.0.0.1:3001/mcp",
      "headers": {
        "Authorization": "Bearer my_secret_token"
      }
    }
  }
}

ركوب الأمواج - ~/.codeium/windsurf/mcp_config.json (المفتاح هو serverUrl):

mcp_config.jsonjson
{
  "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:

config.yamlyaml
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)؛
  • مثيل خادم واحد لكل جلسة، مع انتهاء الصلاحية والحد الأقصى القابل للتكوين؛
  • يقارن الرموز المميزة في وقت ثابت وحدود حجم الجسم المطلوب.

للذهاب أبعد من ذلك#