سرور MCP Firebase

سرور Firebase MCP یک سرور محلی Model Context Protocol (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 CLI را مجاز می‌کنند، اجرا می‌شود. این اعتبارنامه‌ها می‌توانند بسته به محیط، یک کاربر وارد شده یا اعتبارنامه‌های پیش‌فرض برنامه باشند.

قبل از اینکه شروع کنی

مطمئن شوید که 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