خادم Firebase MCP

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

يعمل خادم MCP من Firebase مع أي أداة يمكنها العمل كعميل MCP، بما في ذلك: ‫Firebase Studio وGemini CLI وGemini Code Assist وClaude Code وClaude Desktop وCline وCursor وVS Code Copilot وWindsurf وغيرها.

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

مزايا خادم MCP

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

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

تستخدم بعض الأدوات Gemini في Firebase لمساعدتك في ما يلي:

• إنشاء مخطط وعمليات Firebase Data Connect
• استشارة Gemini بشأن منتجات Firebase

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

إعداد برنامج MCP

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

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

قبل البدء

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

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

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

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

gemini extensions install https://github.com/gemini-cli-extensions/firebase/

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

gemini extensions install https://github.com/gemini-cli-extensions/firebase/

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

claude mcp add firebase npx -- -y firebase-tools@latest mcp

claude mcp list

firebase: npx -y firebase-tools@latest mcp - ✓ Connected

{
  "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 ثلاث فئات مختلفة من ميزات "منصة التسويق المتعدد القنوات":

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

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

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

الطلبات

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

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

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

/firebase:init

في Gemini CLI، ابدأ بكتابة /firebase: للاطّلاع على قائمة بالأوامر المتاحة.

الأدوات

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

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

الموارد

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

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