خادم Firebase MCP

يمكنك استخدام خادم MCP في Firebase لمنح أدوات التطوير المستندة إلى الذكاء الاصطناعي إمكانية العمل مع مشاريعك على Firebase. يعمل خادم MCP من Firebase مع أي أداة يمكنها العمل كعميل MCP، بما في ذلك Claude Desktop وCline وCursor وVisual Studio Code Copilot وWindsurf Editor وغيرها.

يمكن للمحرّر الذي تم إعداده لاستخدام خادم 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 في Firebase طلبات إلى الأدوات، يستخدم بيانات اعتماد المستخدم نفسها التي تمنح الإذن لواجهة سطر الأوامر (CLI) في Firebase في البيئة التي يتم تشغيلها فيها. يمكن أن يكون ذلك مستخدمًا مسجّلاً الدخول أو بيانات الاعتماد التلقائية للتطبيق ، وذلك حسب البيئة.

قبل البدء

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

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

يمكن لخادم MCP في Firebase العمل مع أي عميل MCP يتيح استخدام الإدخال/الإخراج العادي (stdio) كوسيط نقل. في ما يلي تعليمات محدّدة لبعض الأدوات الشائعة:

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

Firebase Studio

لضبط Firebase Studio لاستخدام خادم Firebase MCP، عدِّل ملف الإعداد أو أنشئه: .idx/mcp.json.

إذا لم يكن الملف موجودًا بعد، أنشئه من خلال النقر بزر الماوس الأيمن على الدليل الرئيسي واختيار ملف جديد. أضِف المحتوى التالي إلى الملف:

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

‫Gemini CLI وGemini Code Assist

لضبط Gemini CLI أو Gemini Code Assist لاستخدام خادم Firebase MCP، عدِّل ملفات الإعداد أو أنشئها:

• في مشروعك: .gemini/settings.json
• في الدليل الرئيسي: ~/.gemini/settings.json

إذا لم يكن الملف موجودًا بعد، أنشئه من خلال النقر بزر الماوس الأيمن على الدليل الرئيسي واختيار ملف جديد. أضِف المحتوى التالي إلى الملف:

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

Claude Desktop

لضبط تطبيق Claude Desktop لاستخدام خادم Firebase MCP، عدِّل ملف claude_desktop_config.json. يمكنك فتح هذا الملف أو إنشاؤه من قائمة Claude > الإعدادات. انقر على علامة التبويب المطوّر، ثم على تعديل الإعدادات.

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

Claude Code

لضبط Claude Code لاستخدام خادم MCP في Firebase، شغِّل الأمر التالي ضمن مجلد تطبيقك:

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

يمكنك التحقّق من عملية التثبيت من خلال تنفيذ الأمر التالي:

claude mcp list

يجب أن يعرض ما يلي:

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

Cline

لضبط Cline لاستخدام خادم MCP في Firebase، عدِّل ملف cline_mcp_settings.json. يمكنك فتح هذا الملف أو إنشاؤه من خلال النقر على رمز خوادم MCP في أعلى جزء Cline، ثم النقر على الزر ضبط خوادم MCP.

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

المؤشر

لضبط Cursor لاستخدام خادم Firebase MCP، عدِّل الملف .cursor/mcp.json (لضبط مشروع معيّن فقط) أو الملف ~/.cursor/mcp.json (لإتاحة خادم MCP في جميع المشاريع):

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

‫Visual Studio Code Copilot

لضبط إعدادات مشروع واحد، عدِّل الملف .vscode/mcp.json في مساحة العمل باتّباع الخطوات التالية:

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

لإتاحة الخادم في كل مشروع تفتحه، عدِّل إعدادات المستخدم:

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

محرّر التزلج الشراعي

لإعداد Windsurf Editor، عدِّل الملف ~/.codeium/windsurf/mcp_config.json:

"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "experimental: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", "experimental:mcp",
    "--dir", "/Users/turing/my-project",
    "--only", "auth,firestore,storage"
  ]
}

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

يسرد الجدول التالي الأدوات التي يوفّرها خادم MCP. يمكنك أيضًا الاطّلاع على هذه المعلومات باستخدام الأمر:

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