خادم Firebase MCP

يمكنك استخدام خادم MCP في Firebase لمنح أدوات التطوير المستنِدة إلى الذكاء الاصطناعي إمكانية العمل مع مشاريعك على Firebase وقاعدة الرموز البرمجية لتطبيقك.

يتوافق خادم Firebase MCP مع أي أداة يمكنها العمل كعميل MCP، بما في ذلك: Antigravity وClaude Code وClaude Desktop وCline وCursor وVS Code Copilot وWindsurf وغيرها.

arrow_downward الانتقال إلى تعليمات الإعداد

مزايا خادم MCP

يمكن للمحرِّر الذي تم إعداده لاستخدام خادم MCP على Firebase الاستفادة من إمكانات الذكاء الاصطناعي لمساعدتك في ما يلي:

• إنشاء مشاريع Firebase وإدارتها
• إدارة مستخدمي "مصادقة Firebase"
• العمل باستخدام البيانات في Cloud Firestore وFirebase SQL Connect
• استرداد مخططات Firebase SQL Connect
• فهم قواعد الأمان في Firestore ومساحة تخزين سحابية لـ Firebase
• إرسال الرسائل باستخدام مراسلة Firebase السحابية

هذه القوائم جزئية فقط، لذا يُرجى الاطّلاع على قسم إمكانات الخادم للحصول على قائمة كاملة بالأدوات المتاحة للمحرّر.

إعداد عميل MCP

يمكن لخادم بروتوكول سياق النموذج (MCP) في Firebase العمل مع أي برنامج MCP يتوافق مع معيار الإدخال/الإخراج (stdio) كوسيط نقل.

عندما يُجري خادم MCP في Firebase طلبات إلى الأدوات، يستخدم بيانات اعتماد المستخدم نفسها التي تمنح الإذن لواجهة سطر الأوامر (CLI) في Firebase في البيئة التي يتم تشغيلها فيها. قد يكون ذلك مستخدمًا مسجّلاً الدخول أو بيانات الاعتماد التلقائية للتطبيق، حسب البيئة.

قبل البدء

تأكَّد من تثبيت Node.js وnpm بشكل صحيح.

الإعداد الأساسي

في ما يلي تعليمات أساسية حول إعداد خادم MCP في Firebase لاستخدامه مع بعض الأدوات الشائعة المستندة إلى الذكاء الاصطناعي:

{
  "mcpServers": {
    "firebase-mcp-server": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"],
      "disabled": false
    }
  }
}

"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

"servers": {
  "firebase": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

"mcp": {
  "servers": {
    "firebase": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

الإعدادات الاختيارية

بالإضافة إلى الإعداد الأساسي لكل عميل، الموضّح سابقًا، هناك مَعلمتان اختياريتان يمكنك تحديدهما:

• ‫--dir ABSOLUTE_DIR_PATH: المسار الكامل لدليل يحتوي على firebase.json، وذلك لضبط سياق مشروع لخادم MCP. في حال عدم تحديدها، ستتوفّر الأداتان get_project_directory وset_project_directory، وسيكون الدليل التلقائي هو دليل العمل الذي تم بدء خادم MCP فيه.

• --only FEATURE_1,FEATURE_2: قائمة قيم مفصولة بفاصلة لمجموعات الميزات التي سيتم تفعيلها. استخدِم هذا الخيار للحدّ من الأدوات المعروضة لتقتصر على الميزات التي تستخدمها حاليًا. يُرجى العِلم أنّ الأدوات الأساسية متاحة دائمًا.

على سبيل المثال:

"firebase": {
  "command": "npx",
  "args": [
    "-y",
    "firebase-tools@latest", "mcp",
    "--dir", "/Users/turing/my-project",
    "--only", "auth,firestore,storage"
  ]
}

إمكانات خادم MCP

يوفّر خادم Firebase MCP ثلاث فئات مختلفة من ميزات MCP:

• الطلبات: مكتبة من الطلبات المكتوبة مسبقًا التي يمكنك تنفيذها، وهي محسّنة لتطوير تطبيق وتشغيله باستخدام Firebase

• الأدوات: مجموعة من الأدوات المخصّصة للاستخدام من قِبل النماذج اللغوية الكبيرة، وهي تساعدها في العمل مباشرةً مع مشروعك على Firebase (بعد موافقتك).

• المراجع: ملفات المستندات المخصّصة للاستخدام من قِبل النماذج اللغوية الكبيرة بهدف تزويدها بإرشادات وسياق إضافيين لإكمال مهمة أو هدف

الطلبات

يتضمّن خادم Firebase MCP مكتبة من الطلبات المكتوبة مسبقًا والمحسَّنة لتطوير تطبيق وتشغيله باستخدام Firebase. يمكنك استخدام هذه الطلبات لإكمال مجموعة متنوعة من المهام أو الأهداف الشائعة باستخدام مساعدات الذكاء الاصطناعي المستقلة.

يوضّح الجدول التالي الطلبات التي يتيحها خادم MCP.

توفّر العديد من أدوات التطوير التي تتوافق مع MCP طريقة سهلة لتنفيذ هذه الطلبات. على سبيل المثال، كأمر يبدأ بشرطة مائلة:

/firebase:init

في البيئات المتوافقة، يمكنك بدء الكتابة /firebase: لعرض قائمة بالطلبات المتاحة.

npx firebase-tools@latest mcp --generate-prompt-list

الأدوات

يوفّر خادم MCP في Firebase أيضًا عددًا من الأدوات المخصّصة للاستخدام من قِبل النماذج اللغوية الكبيرة، والتي تساعدها في العمل مباشرةً مع مشروعك على Firebase (بعد موافقتك). على عكس الطلبات، لا يمكنك استدعاء هذه الأدوات مباشرةً، بل يمكن للنماذج التي تتيح استدعاء الأدوات (مثل Gemini وClaude وGPT) استدعاء هذه الأدوات تلقائيًا لتنفيذ مهام التطوير عند الحاجة.

يوضّح الجدول التالي الأدوات التي يوفّرها خادم MCP.

npx firebase-tools@latest mcp --generate-tool-list

الموارد

يوفّر خادم MCP موارد، وهي ملفات مستندات مخصّصة للاستخدام من قِبل نماذج اللغات الكبيرة. ستتضمّن النماذج التي تتيح استخدام الموارد تلقائيًا الموارد ذات الصلة في سياق الجلسة.

يوضّح الجدول التالي الموارد التي يتيحها خادم MCP.

npx firebase-tools@latest mcp --generate-resource-list