خادم Firebase MCP

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

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

قبل البدء

1. تأكَّد من تثبيت Node.js وnpm بشكلٍ سليم.

2. مصادقة واجهة برمجة التطبيقات Firebase CLI من خلال تنفيذ الأمر التالي:

   npx -y firebase-tools@latest login --reauth

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

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

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

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

Claude Desktop

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

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

كرم

لضبط Cline لاستخدام خادم Firebase MCP، عدِّل ملف cline_mcp_settings.json. يمكنك فتح هذا الملف أو إنشاؤه من خلال النقر على رمز "خوادم MCP" في أعلى لوحة "العملاء"، ثم النقر على الزر ضبط خوادم 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