خادم Firebase MCP

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

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

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

مزايا خادم MCP

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

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

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

إعداد عميل MCP

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

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

قبل البدء

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

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

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

{
  "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
    }
  }
}

"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

الأدوات

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

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

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

{
  "parent": "projects/my-project/databases/(default)/documents",
  "structured_aggregation_query": {
    "structured_query": {
      "from": [{"collection_id": "orders"}],
      "where": {
        "field_filter": {
          "field": {"field_path": "status"},
          "op": "EQUAL",
          "value": {"string_value": "COMPLETED"}
        }
      }
    },
    "aggregations": [
      {
        "alias": "total_orders",
        "count": {}
      },
      {
        "alias": "average_amount",
        "avg": {
          "field": {"field_path": "amount"}
        }
      }
    ]
  }
}

الموارد

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

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

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