MCP-сервер Firebase

MCP-сервер Firebase – это локальный сервер 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-клиент

MCP-сервер Firebase – это локальный MCP-сервер, который может работать с любым MCP-клиентом, поддерживающим стандартный ввод-вывод (stdio) в качестве транспортной среды.

Когда MCP-сервер Firebase вызывает инструменты, он работает локально в вашей среде, используя те же учетные данные пользователя, которые авторизуют CLI 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-сервера

MCP-сервер Firebase предоставляет три категории функций MCP:

• Запросы. Библиотека готовых запросов, оптимизированных для разработки и запуска приложений с помощью Firebase.

• Инструменты. Набор инструментов, предназначенных для использования ИИ-агентами, которые помогают им работать непосредственно с вашим проектом Firebase (с вашего одобрения).

• Ресурсы. Файлы документации, предназначенные для использования ИИ-агентами, чтобы дать им больше рекомендаций и контекста для выполнения задачи или цели.

запросы;

В MCP-сервере Firebase есть библиотека готовых запросов, оптимизированных для разработки и запуска приложений с помощью Firebase. Вы можете использовать эти запросы для выполнения различных распространенных задач или целей с помощью агентных ИИ-помощников.

В таблице ниже описаны запросы, доступные на сервере MCP.

Многие инструменты разработки, поддерживающие 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