خادم Firebase MCP

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

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

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

مزايا خادم MCP

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

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

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

إعداد عميل MCP

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

عندما ينفّذ خادم MCP في Firebase طلبات الأدوات، يتم تشغيله محليًا في بيئتك باستخدام بيانات اعتماد المستخدم نفسها التي تفوّض واجهة سطر الأوامر 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
    }
  }
}

"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.

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

/firebase:init

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

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

الأدوات

يوفّر خادم MCP في Firebase أيضًا عددًا من الأدوات التي يمكن لوكلاء الذكاء الاصطناعي استخدامها لمساعدتهم في العمل مباشرةً مع مشروعك على 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