Firebase MCP Server

Firebase MCP Server

Сервер Firebase Model Context Protocol (MCP) предоставляет AI-инструментам для разработки возможность работать с вашими проектами Firebase и кодовой базой вашего приложения. Сервер Firebase MCP работает с любым инструментом, который может выступать в роли MCP-клиента, включая: Firebase Studio, Gemini CLI, Claude Code, Cline, Cursor, VS Code Copilot, Windsurf и другие!

Возможности

Редактор, настроенный на использование сервера Firebase MCP, может использовать свои AI-возможности, чтобы помочь вам:

• Создавать и управлять проектами Firebase — Инициализировать новые проекты, просматривать существующие и управлять приложениями Firebase
• Управлять пользователями Firebase Authentication — Получать, обновлять и управлять учетными записями пользователей
• Работать с Cloud Firestore и Firebase SQL Connect — Запрашивать, читать, записывать и управлять документами базы данных
• Получать схемы Firebase SQL Connect — Генерировать схемы и операции с помощью AI
• Понимать правила безопасности — Проверять и получать правила безопасности для Firestore, Cloud Storage и Realtime Database
• Отправлять сообщения с помощью Firebase Cloud Messaging — Отправлять push-уведомления на устройства и темы
• Получать доступ к данным Crashlytics — Отлаживать проблемы, просматривать отчеты о сбоях и управлять аналитикой сбоев
• Развертывать в App Hosting — Отслеживать бэкенды и получать журналы
• Работать с Realtime Database — Читать и записывать данные в реальном времени
• Запрашивать журналы Cloud Functions — Получать и анализировать журналы выполнения функций
• Управлять Remote Config — Получать и обновлять шаблоны удаленной конфигурации

Некоторые инструменты используют Gemini in Firebase, чтобы помочь вам:

• Генерировать схему и операции Firebase SQL Connect
• Консультироваться с Gemini о продуктах Firebase

Важно: Gemini in Firebase может генерировать результаты, которые кажутся правдоподобными, но фактически неверны. Он может отвечать неточной информацией, которая не отражает мнение Google. Проверяйте все результаты Gemini перед использованием и не используйте непроверенный сгенерированный код в производстве. Не вводите личную информацию (PII) или пользовательские данные в чат.
Узнайте больше о Gemini in Firebase и о том, как он использует ваши данные.

Установка и настройка

Предварительные требования

Убедитесь, что у вас есть рабочая установка Node.js и npm.

Базовая конфигурация

Сервер Firebase MCP может работать с любым MCP-клиентом, поддерживающим стандартный ввод-вывод (stdio) в качестве транспортного средства. Когда сервер Firebase MCP выполняет вызовы инструментов, он использует те же учетные данные пользователя, которые авторизуют Firebase CLI в среде, где он запущен.

Вот инструкции по настройке для популярных AI-инструментов:

Gemini CLI

Установите расширение Firebase для Gemini CLI:

gemini extensions install https://github.com/firebase/agent-skills

Claude Code

Вариант 1: Установка через плагин (рекомендуется)

Самый простой способ настроить сервер Firebase MCP в Claude Code — установить официальный плагин Firebase:

1. Добавьте маркетплейс Firebase для плагинов Claude:

   claude plugin marketplace add firebase/firebase-tools
   

2. Установите плагин Claude для Firebase:

   claude plugin install firebase@firebase
   

3. Проверьте установку:

   claude plugin
   

Вариант 2: Настройка MCP-сервера вручную

В качестве альтернативы вы можете вручную настроить сервер Firebase MCP, выполнив:

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

Вы можете проверить установку, выполнив:

claude mcp list

Должно отобразиться:

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

Cursor

Добавьте в .cursorrules в каталоге вашего проекта или настройте в параметрах Cursor:

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

Windsurf

Добавьте в ~/.codeium/windsurf/mcp_config.json:

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

Firebase Studio

Чтобы настроить Firebase Studio для использования сервера Firebase MCP, отредактируйте или создайте файл конфигурации: .idx/mcp.json

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

Использование

После настройки MCP-сервер автоматически предоставит возможности Firebase вашему AI-ассистенту. Вы можете:

• Попросить AI помочь настроить сервисы Firebase
• Запрашивать вашу базу данных Firestore
• Управлять пользователями аутентификации
• Развертывать в Firebase Hosting
• Отлаживать проблемы Crashlytics
• И многое другое!

Полный список доступных инструментов и ресурсов см. в разделе Server Capabilities ниже.

Документация

Для получения дополнительной информации посетите официальную документацию сервера Firebase MCP.

Возможности сервера

Сервер Firebase MCP предоставляет три типа возможностей: Tools (функции, выполняющие действия), Prompts (многоразовые шаблоны команд) и Resources (файлы документации для AI-моделей).

Имя инструмента	Группа функций	Описание
apphosting_fetch_logs	apphosting	Получение последних журналов службы или сборки для бэкенда App Hosting.
apphosting_list_backends	apphosting	Список бэкендов App Hosting, конфигураций трафика и пользовательских доменов в вашем проекте.
auth_get_users	auth	Получение пользователей Firebase Auth по UID, email, номеру телефона или список всех пользователей.
auth_update_user	auth	Обновление учетной записи пользователя путем ее включения/отключения или установки пользовательских утверждений.
auth_set_sms_region_policy	auth	Установка политики региона SMS, разрешающей или запрещающей определенные коды стран для Firebase Authentication.
firebase_login	core	Вход пользователя в Firebase CLI и MCP сервер или проверка текущего статуса аутентификации.
firebase_logout	core	Выход пользователя из Firebase CLI и MCP сервера.
firebase_validate_security_rules	core	Проверка синтаксиса и поиск ошибок в правилах безопасности Firestore, Storage или Realtime Database.
firebase_get_project	core	Получение метаданных и деталей конфигурации для текущего активного проекта Firebase.
firebase_list_apps	core	Список всех приложений Firebase, зарегистрированных в активном проекте.
firebase_list_projects	core	Список проектов Firebase, доступных аутентифицированному пользователю.
firebase_get_sdk_config	core	Получение деталей конфигурации SDK или содержимого файлов конфигурации для зарегистрированного приложения Firebase.
firebase_create_project	core	Создание нового проекта Firebase или включение сервисов Firebase в существующем проекте Google Cloud.
firebase_create_app	core	Создание нового приложения iOS, Android или Web в активном проекте Firebase.
firebase_create_android_sha	core	Добавление хеша сертификата SHA-1 или SHA-256 в приложение Android в активном проекте Firebase.
firebase_get_environment	core	Получение текущей конфигурации окружения Firebase CLI и MCP, активного проекта и аутентифицированного пользователя.
firebase_update_environment	core	Обновление настроек окружения, таких как каталог проекта, активный проект или учетная запись активного пользователя.
firebase_init	core	Инициализация и настройка сервисов Firebase в вашем локальном рабочем пространстве проекта.
firebase_get_security_rules	core	Получение активных правил безопасности для Firestore, Storage или Realtime Database.
firebase_read_resources	core	Чтение содержимого внутренних ресурсов документации firebase:// или список всех доступных ресурсов.
crashlytics_create_note	crashlytics	Добавление заметки к проблеме Crashlytics для приложения Android или iOS.
crashlytics_delete_note	crashlytics	Удаление заметки из проблемы Crashlytics для приложения Android или iOS.
crashlytics_get_issue	crashlytics	Получение деталей и метаданных для конкретной проблемы Crashlytics.
crashlytics_list_events	crashlytics	Список последних событий сбоев и исключений, соответствующих указанным фильтрам для проблемы.
crashlytics_batch_get_events	crashlytics	Получение примеров событий сбоев и исключений по имени ресурса для отладки.
crashlytics_list_notes	crashlytics	Список всех заметок, прикрепленных к проблеме Crashlytics для приложения Android или iOS.
crashlytics_get_report	crashlytics	Генерация агрегированных числовых отчетов по проблемам и событиям Crashlytics.
crashlytics_update_issue	crashlytics	Обновление состояния (OPEN или CLOSED) проблемы Crashlytics.
realtimedatabase_get_data	realtimedatabase	Чтение данных по указанному пути в Firebase Realtime Database.
realtimedatabase_set_data	realtimedatabase	Запись данных JSON по указанному пути в Firebase Realtime Database.
dataconnect_build	dataconnect	Компиляция схем, операций и коннекторов Firebase SQL Connect для проверки синтаксиса и типов.
dataconnect_list_services	dataconnect	Список локальных и развернутых сервисов, схем и коннекторов Firebase SQL Connect.
dataconnect_execute	dataconnect	Выполнение GraphQL запроса или мутации против сервиса или эмулятора Firebase SQL Connect.
firestore_delete_document	firestore	Используйте это для удаления документов Firestore из базы данных в текущем проекте по полным путям документов. Используйте это, если вы знаете точный путь документа.
firestore_get_documents	firestore	Используйте это для получения одного или нескольких документов Firestore из базы данных в текущем проекте по полным путям документов. Используйте это, если вы знаете точный путь документа.
firestore_list_collections	firestore	Используйте это для получения списка коллекций из базы данных Firestore в текущем проекте.
firestore_query_collection	firestore	Запрос документов Firestore из коллекции с необязательными фильтрами и сортировкой.
functions_get_logs	functions	Получение и фильтрация записей журналов Cloud Functions из Google Cloud Logging.
functions_list_functions	functions	Список всех развернутых Cloud Functions в вашем проекте Firebase.
messaging_send_message	messaging	Отправка push-уведомления Firebase Cloud Messaging на токен регистрации устройства или тему.
remoteconfig_get_template	remoteconfig	Получение активной или указанной версии шаблона Firebase Remote Config.
remoteconfig_update_template	remoteconfig	Публикация нового шаблона Firebase Remote Config или откат к предыдущей версии.
storage_get_object_download_url	storage	Получение URL-адреса загрузки для объекта в корзине Cloud Storage.

Имя промпта	Группа функций	Описание
firebase:deploy	core	Используйте эту команду для развертывания ресурсов в Firebase. Аргументы: <prompt> (необязательно): любые конкретные инструкции, которые вы хотите предоставить о развертывании
firebase:init	core	Используйте эту команду для настройки сервисов Firebase, таких как бэкенд и функции ИИ.
firestore:generate_security_rules	firestore	Генерация безопасных правил безопасности Firebase Firestore и соответствующих модульных тестов для вашего проекта.
storage:generate_security_rules	storage	Генерация безопасных правил безопасности Firebase Storage и соответствующих модульных тестов для вашего проекта.
crashlytics:connect	crashlytics	Используйте эту команду для доступа к данным Crashlytics приложения Firebase.
Название ресурса	Описание
-------------------------------	------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
app_id_guide	Руководство по идентификатору приложения Firebase: помогает агенту кодирования выбрать идентификатор приложения Firebase в текущем проекте
crashlytics_investigations_guide	Руководство по расследованию Crashlytics Firebase: помогает агенту кодирования при расследовании ошибок, сообщенных в проблемах Crashlytics, включая процедуры диагностики и исправления сбоев.
crashlytics_issues_guide	Руководство по проблемам Crashlytics Firebase: помогает агенту кодирования при работе с проблемами Crashlytics, включая правила приоритизации и процедуры диагностики и исправления сбоев.
crashlytics_reports_guide	Руководство по отчетам Crashlytics Firebase: помогает агенту кодирования запрашивать отчеты Crashlytics, включая настройку соответствующих фильтров и понимание метрик. Агент должен прочитать это руководство перед запросом любого отчета.
backend_init_guide	Руководство по инициализации бэкенда Firebase: помогает агенту кодирования настраивать серверные сервисы Firebase в текущем проекте
ai_init_guide	Руководство по инициализации GenAI Firebase: помогает агенту кодирования настраивать возможности GenAI в текущем проекте с использованием Firebase
firestore_init_guide	Руководство по инициализации Firestore: помогает агенту кодирования настраивать Firestore в текущем проекте
firestore_rules_init_guide	Руководство по инициализации правил Firestore: помогает агенту кодирования настраивать правила безопасности Firestore в проекте
auth_init_guide	Руководство по инициализации аутентификации Firebase: помогает агенту кодирования настраивать аутентификацию Firebase в текущем проекте
hosting_init_guide	Руководство по развертыванию Firebase Hosting: помогает агенту кодирования развертывать на Firebase Hosting в текущем проекте
docs	Документация Firebase: загружает текстовое содержимое из документации Firebase, например, https://firebase.google.com/docs/functions становится firebase://docs/functions