سرور MCP Firebase

می توانید از سرور Firebase MCP استفاده کنید تا به ابزارهای توسعه مبتنی بر هوش مصنوعی توانایی کار با پروژه های Firebase خود را بدهید. سرور Firebase MCP با هر ابزاری که می تواند به عنوان یک مشتری MCP عمل کند، از جمله Claude Desktop، Cline، Cursor، Visual Studio Code Copilot، Windsurf Editor و غیره کار می کند.

ویرایشگر پیکربندی شده برای استفاده از سرور Firebase MCP می تواند از قابلیت های هوش مصنوعی خود برای کمک به شما استفاده کند:

• پروژه های Firebase را ایجاد و مدیریت کنید
• کاربران Firebase Authentication خود را مدیریت کنید
• با داده ها در Cloud Firestore و Firebase Data Connect کار کنید
• طرحواره های Firebase Data Connect را بازیابی کنید
• قوانین امنیتی خود را برای Firestore و Cloud Storage برای Firebase بدانید
• با Firebase Cloud Messaging پیام ارسال کنید

برخی از ابزارها از Gemini در Firebase برای کمک به شما استفاده می کنند:

• طرح و عملیات Firebase Data Connect را ایجاد کنید
• در مورد محصولات Firebase با Gemini مشورت کنید

اینها فقط لیست های جزئی هستند. برای لیست کامل ابزارهای موجود در ویرایشگر خود، بخش قابلیت های سرور را ببینید.

هنگامی که سرور Firebase MCP تماس ابزار برقرار می کند، از همان اعتبار کاربری استفاده می کند که Firebase CLI را در محیطی که در آن اجرا می شود مجاز می کند. بسته به محیط، این می تواند یک کاربر وارد شده یا اعتبار پیش فرض برنامه باشد.

قبل از شروع

مطمئن شوید که Node.js و npm را نصب کرده اید.

سرویس گیرنده MCP خود را تنظیم کنید

سرور Firebase MCP می تواند با هر مشتری MCP که از I/O استاندارد (stdio) به عنوان رسانه انتقال پشتیبانی می کند، کار کند.

پیکربندی اولیه

در این بخش، می‌توانید دستورالعمل‌های خاصی را برای برخی از ابزارهای محبوب کمکی هوش مصنوعی بیابید:

• استودیو Firebase
• Gemini CLI و Gemini Code Assist
• کد کلود
• کلود دسکتاپ
• کلین
• مکان نما
• Visual Studio Code Copilot
• ویرایشگر Windsurf

استودیو Firebase

برای پیکربندی 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، نصب افزونه Firebase برای Gemini CLI است:

gemini extensions install https://github.com/gemini-cli-extensions/firebase/

نصب برنامه افزودنی Firebase به طور خودکار سرور Firebase MCP را پیکربندی می کند و همچنین با یک فایل زمینه ارائه می شود که می تواند عملکرد توسعه برنامه Firebase Gemini را بهبود بخشد.

همچنین، می‌توانید Gemini CLI یا Gemini Code Assist را برای استفاده از سرور MCP Firebase (اما نه فایل زمینه پسوند Firebase) با ویرایش یا ایجاد یکی از فایل‌های پیکربندی پیکربندی کنید:

• در پروژه شما: .gemini/settings.json
• در فهرست اصلی شما: ~/.gemini/settings.json

اگر فایل هنوز وجود ندارد، با کلیک راست روی پوشه والد و انتخاب فایل جدید ، آن را ایجاد کنید. مطالب زیر را به فایل اضافه کنید:

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

کد کلود

برای پیکربندی Claude Code برای استفاده از سرور Firebase MCP، دستور زیر را در پوشه برنامه خود اجرا کنید:

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

می توانید نصب را با اجرای زیر تأیید کنید:

claude mcp list

باید نشان دهد:

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

کلود دسکتاپ

برای پیکربندی Claude Desktop برای استفاده از سرور Firebase MCP، فایل claude_desktop_config.json را ویرایش کنید. می توانید این فایل را از منوی Claude > Settings باز یا ایجاد کنید. برگه Developer را انتخاب کنید، سپس روی Edit Config کلیک کنید.

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

کلین

برای پیکربندی Cline برای استفاده از سرور MCP Firebase، فایل cline_mcp_settings.json را ویرایش کنید. می‌توانید این فایل را با کلیک کردن روی نماد سرورهای MCP در بالای صفحه Cline باز یا ایجاد کنید، سپس روی دکمه پیکربندی سرورهای MCP کلیک کنید.

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

مکان نما

برای پیکربندی مکان نما برای استفاده از سرور MCP Firebase، فایل .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

برای پیکربندی ویرایشگر Windsurf، فایل ~/.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

سرور Firebase MCP سه دسته مختلف از ویژگی های MCP را ارائه می دهد: درخواست ها، ابزارها و منابع.

درخواست می کند

سرور Firebase MCP دارای یک کتابخانه از دستورات از پیش نوشته شده است که برای توسعه برنامه Firebase بهینه شده است. شما می توانید این دستورات را برای تکمیل وظایف مختلف توسعه Firebase اجرا کنید.

اکثر ابزارهای توسعه ای که از MCP پشتیبانی می کنند، راه مناسبی برای اجرای این دستورات ارائه می دهند. به عنوان مثال، Gemini CLI این دستورات را به عنوان دستورات اسلش در دسترس قرار می دهد:

/firebase:init

/firebase: را در Gemini CLI تایپ کنید تا لیستی از دستورات موجود را ببینید که در جدول زیر نیز فهرست شده است:

شما همچنین می توانید این اطلاعات را با استفاده از دستور مشاهده کنید:

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

ابزار

سرور Firebase MCP همچنین تعدادی ابزار را فراهم می کند که به LLM ها اجازه می دهد مستقیماً با پروژه Firebase شما (با تأیید شما!) کار کنند. برخلاف دستورات، شما مستقیماً با این ابزارها تماس نمی‌گیرید. در عوض، مدل هایی که از فراخوانی ابزار پشتیبانی می کنند (مانند Gemini، Claude و GPT) می توانند به طور خودکار این ابزارها را برای انجام وظایف توسعه در صورت نیاز فراخوانی کنند.

جدول زیر ابزارهایی را که سرور MCP در دسترس قرار می دهد فهرست می کند.

شما همچنین می توانید این اطلاعات را با استفاده از دستور مشاهده کنید:

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

منابع

سرور MCP منابعی را فراهم می کند که فایل های مستندی هستند که برای استفاده توسط LLM ها در نظر گرفته شده است. مدل هایی که از استفاده از منابع پشتیبانی می کنند به طور خودکار منابع مربوطه را در زمینه جلسه شامل می شوند.

جدول زیر منابعی را که سرور MCP در دسترس قرار می دهد فهرست می کند.

شما همچنین می توانید این اطلاعات را با استفاده از دستور مشاهده کنید:

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

می توانید از سرور Firebase MCP استفاده کنید تا به ابزارهای توسعه مبتنی بر هوش مصنوعی توانایی کار با پروژه های Firebase خود را بدهید. سرور Firebase MCP با هر ابزاری که می تواند به عنوان یک مشتری MCP عمل کند، از جمله Claude Desktop، Cline، Cursor، Visual Studio Code Copilot، Windsurf Editor و غیره کار می کند.

ویرایشگر پیکربندی شده برای استفاده از سرور Firebase MCP می تواند از قابلیت های هوش مصنوعی خود برای کمک به شما استفاده کند:

• پروژه های Firebase را ایجاد و مدیریت کنید
• کاربران Firebase Authentication خود را مدیریت کنید
• با داده ها در Cloud Firestore و Firebase Data Connect کار کنید
• طرحواره های Firebase Data Connect را بازیابی کنید
• قوانین امنیتی خود را برای Firestore و Cloud Storage برای Firebase بدانید
• با Firebase Cloud Messaging پیام ارسال کنید

برخی از ابزارها از Gemini در Firebase برای کمک به شما استفاده می کنند:

• طرح و عملیات Firebase Data Connect را ایجاد کنید
• در مورد محصولات Firebase با Gemini مشورت کنید

اینها فقط لیست های جزئی هستند. برای لیست کامل ابزارهای موجود در ویرایشگر خود، بخش قابلیت های سرور را ببینید.

هنگامی که سرور Firebase MCP تماس ابزار برقرار می کند، از همان اعتبار کاربری استفاده می کند که Firebase CLI را در محیطی که در آن اجرا می شود مجاز می کند. بسته به محیط، این می تواند یک کاربر وارد شده یا اعتبار پیش فرض برنامه باشد.

قبل از شروع

مطمئن شوید که Node.js و npm را نصب کرده اید.

سرویس گیرنده MCP خود را تنظیم کنید

سرور Firebase MCP می تواند با هر مشتری MCP که از I/O استاندارد (stdio) به عنوان رسانه انتقال پشتیبانی می کند، کار کند.

پیکربندی اولیه

در این بخش، می‌توانید دستورالعمل‌های خاصی را برای برخی از ابزارهای محبوب کمکی هوش مصنوعی بیابید:

• استودیو Firebase
• Gemini CLI و Gemini Code Assist
• کد کلود
• کلود دسکتاپ
• کلین
• مکان نما
• Visual Studio Code Copilot
• ویرایشگر Windsurf

استودیو Firebase

برای پیکربندی 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، نصب افزونه Firebase برای Gemini CLI است:

gemini extensions install https://github.com/gemini-cli-extensions/firebase/

نصب برنامه افزودنی Firebase به طور خودکار سرور Firebase MCP را پیکربندی می کند و همچنین با یک فایل زمینه ارائه می شود که می تواند عملکرد توسعه برنامه Firebase Gemini را بهبود بخشد.

همچنین، می‌توانید Gemini CLI یا Gemini Code Assist را برای استفاده از سرور MCP Firebase (اما نه فایل زمینه پسوند Firebase) با ویرایش یا ایجاد یکی از فایل‌های پیکربندی پیکربندی کنید:

• در پروژه شما: .gemini/settings.json
• در فهرست اصلی شما: ~/.gemini/settings.json

اگر فایل هنوز وجود ندارد، با کلیک راست روی پوشه والد و انتخاب فایل جدید ، آن را ایجاد کنید. مطالب زیر را به فایل اضافه کنید:

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

کد کلود

برای پیکربندی Claude Code برای استفاده از سرور Firebase MCP، دستور زیر را در پوشه برنامه خود اجرا کنید:

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

می توانید نصب را با اجرای زیر تأیید کنید:

claude mcp list

باید نشان دهد:

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

کلود دسکتاپ

برای پیکربندی Claude Desktop برای استفاده از سرور Firebase MCP، فایل claude_desktop_config.json را ویرایش کنید. می توانید این فایل را از منوی Claude > Settings باز یا ایجاد کنید. برگه Developer را انتخاب کنید، سپس روی Edit Config کلیک کنید.

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

کلین

برای پیکربندی Cline برای استفاده از سرور MCP Firebase، فایل cline_mcp_settings.json را ویرایش کنید. می‌توانید این فایل را با کلیک کردن روی نماد سرورهای MCP در بالای صفحه Cline باز یا ایجاد کنید، سپس روی دکمه پیکربندی سرورهای MCP کلیک کنید.

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

مکان نما

برای پیکربندی مکان نما برای استفاده از سرور MCP Firebase، فایل .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

برای پیکربندی ویرایشگر Windsurf، فایل ~/.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

سرور Firebase MCP سه دسته مختلف از ویژگی های MCP را ارائه می دهد: درخواست ها، ابزارها و منابع.

درخواست می کند

سرور Firebase MCP دارای یک کتابخانه از دستورات از پیش نوشته شده است که برای توسعه برنامه Firebase بهینه شده است. شما می توانید این دستورات را برای تکمیل وظایف مختلف توسعه Firebase اجرا کنید.

اکثر ابزارهای توسعه ای که از MCP پشتیبانی می کنند، راه مناسبی برای اجرای این دستورات ارائه می دهند. به عنوان مثال، Gemini CLI این دستورات را به عنوان دستورات اسلش در دسترس قرار می دهد:

/firebase:init

/firebase: را در Gemini CLI تایپ کنید تا لیستی از دستورات موجود را ببینید که در جدول زیر نیز فهرست شده است:

شما همچنین می توانید این اطلاعات را با استفاده از دستور مشاهده کنید:

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

ابزار

سرور Firebase MCP همچنین تعدادی ابزار را فراهم می کند که به LLM ها اجازه می دهد مستقیماً با پروژه Firebase شما (با تأیید شما!) کار کنند. برخلاف دستورات، شما مستقیماً با این ابزارها تماس نمی‌گیرید. در عوض، مدل هایی که از فراخوانی ابزار پشتیبانی می کنند (مانند Gemini، Claude و GPT) می توانند به طور خودکار این ابزارها را برای انجام وظایف توسعه در صورت نیاز فراخوانی کنند.

جدول زیر ابزارهایی را که سرور MCP در دسترس قرار می دهد فهرست می کند.

شما همچنین می توانید این اطلاعات را با استفاده از دستور مشاهده کنید:

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

منابع

The MCP server provides resources, which are documentation files intended for use by LLMs. Models that support using resources will automatically include relevant resources in the session context.

The following table lists the resources the MCP server makes available.

You can also see this information using the command:

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