Сервер Firebase MCP

Сервер Firebase MCP — это локальный сервер протокола контекста модели (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:

• Prompts : Библиотека готовых сценариев подсказок, которые вы можете запускать; они оптимизированы для разработки и запуска приложений с использованием 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