Firebase MCP

Обзор

Firebase MCP позволяет помощникам на базе искусственного интеллекта работать напрямую со службами Firebase, включая:

Firestore : Операции с базой данных документов
Хранилище : управление файлами с надежными возможностями загрузки
Аутентификация : управление пользователями и проверка

Сервер работает с клиентскими приложениями MCP, такими как Claude Desktop , Augment Code , VS Code и Cursor .

⚡ Быстрый старт

Предпосылки

Проект Firebase с учетными данными сервисной учетной записи
Среда Node.js

1. Установите MCP-сервер

Добавьте конфигурацию сервера в файл настроек MCP:

Рабочий стол Клода: ~/Library/Application Support/Claude/claude_desktop_config.json
Дополнение: ~/Library/Application Support/Code/User/settings.json
Курсор: [project root]/.cursor/mcp.json

MCP-серверы можно устанавливать вручную или во время выполнения через npx (рекомендуется). Способ установки определяет вашу конфигурацию:

Настроить для npx (рекомендуется)

{
  "firebase-mcp": {
    "command": "npx",
    "args": [
      "-y",
      "@gannonh/firebase-mcp"
    ],
    "env": {
      "SERVICE_ACCOUNT_KEY_PATH": "/absolute/path/to/serviceAccountKey.json",
      "FIREBASE_STORAGE_BUCKET": "your-project-id.firebasestorage.app"
    }
  }
}

Настроить для локальной установки

{
  "firebase-mcp": {
    "command": "node",
    "args": [
      "/absolute/path/to/firebase-mcp/dist/index.js"
    ],
    "env": {
      "SERVICE_ACCOUNT_KEY_PATH": "/absolute/path/to/serviceAccountKey.json",
      "FIREBASE_STORAGE_BUCKET": "your-project-id.firebasestorage.app"
    }
  }
}

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

Попросите своего клиента ИИ: «Пожалуйста, протестируйте все инструменты Firebase MCP».

🔥 Последние функции: загрузка хранилища (v1.3.3)

Firebase MCP теперь предлагает мощные возможности загрузки файлов с помощью двух специализированных инструментов:

storage_upload : загрузка файлов из текста, содержимого base64 или локальных путей к файлам
storage_upload_from_url : Импорт файлов напрямую с внешних URL-адресов

Основные преимущества

Постоянные публичные URL-адреса : все загрузки генерируют неограниченные публичные URL-адреса.
Определение типа контента : автоматическое определение по расширениям файлов и данным
Несколько методов загрузки : гибкие возможности для разных вариантов использования
Расширенное форматирование ответов : понятные, хорошо структурированные подтверждения загрузки

Методы загрузки

Локальный путь к файлу (рекомендуется для всех типов файлов)
{ filePath: "my-report.pdf", content: "/path/to/local/file.pdf" }
URL-адрес данных Base64 (для файлов меньшего размера)
{ filePath: "my-image.png", content: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..." }
Обычный текст (для текстовых файлов)
{ filePath: "readme.md", content: "# My README\n\nThis is a markdown file." }
Внешний URL (используя storage_upload_from_url)
{ filePath: "document.pdf", url: "https://example.com/document.pdf" }

⚠️ Важно: для двоичных файлов, таких как изображения и PDF-файлы, всегда используйте метод прямого пути к файлу для большей надежности.

🛠️ Настройка и конфигурирование

1. Конфигурация Firebase

Перейдите в Firebase Console → Настройки проекта → Учетные записи служб.
Нажмите «Сгенерировать новый закрытый ключ».
Сохраните файл JSON в надежном месте

2. Переменные среды

SERVICE_ACCOUNT_KEY_PATH : путь к ключу учетной записи службы Firebase в формате JSON (обязательно)
FIREBASE_STORAGE_BUCKET : Имя контейнера для Firebase Storage (необязательно, по умолчанию [projectId].appspot.com )

3. Интеграция клиента

Клод Десктоп

Редактировать: ~/Library/Application Support/Claude/claude_desktop_config.json

VS Code / Дополнение

Редактировать: ~/Library/Application Support/Code/User/settings.json

Курсор

Редактировать: [project root]/.cursor/mcp.json

📚 API-ссылка

Инструменты для пожаротушения

Инструмент	Описание	Требуемые параметры
`firestore_add_document`	Добавить документ в коллекцию	`collection` `data`
`firestore_list_documents`	Список документов с фильтрацией	`collection`
`firestore_get_document`	Получить конкретный документ	`collection` , `id`
`firestore_update_document`	Обновить существующий документ	`collection` , `id` , `data`
`firestore_delete_document`	Удалить документ	`collection` , `id`
`firestore_list_collections`	Список корневых коллекций	Никто
`firestore_query_collection_group`	Запрос по подколлекциям	`collectionId`

Инструменты для хранения

Инструмент	Описание	Требуемые параметры
`storage_list_files`	Список файлов в каталоге	Нет (необязательно: `directoryPath` )
`storage_get_file_info`	Получить метаданные файла и URL	`filePath`
`storage_upload`	Загрузить файл из контента	`filePath` , `content`
`storage_upload_from_url`	Загрузить файл с URL	`filePath` , `url`

Инструменты аутентификации

Инструмент	Описание	Требуемые параметры
`auth_get_user`	Получить пользователя по ID или адресу электронной почты	`identifier`

💻 Руководство разработчика

Монтаж и строительство

git clone https://github.com/gannonh/firebase-mcp
cd firebase-mcp
npm install
npm run build

Проведение тестов

Сначала установите и запустите эмуляторы Firebase:

npm install -g firebase-tools
firebase init emulators
firebase emulators:start

Затем проведите тесты:

# Run tests with emulator
npm run test:emulator

# Run tests with coverage
npm run test:coverage:emulator

Структура проекта

src/
├── index.ts                  # Server entry point
├── utils/                    # Utility functions
└── lib/
    └── firebase/              # Firebase service clients
        ├── authClient.ts     # Authentication operations
        ├── firebaseConfig.ts   # Firebase configuration
        ├── firestoreClient.ts # Firestore operations
        └── storageClient.ts  # Storage operations

🔍 Устранение неполадок

Общие проблемы

Контейнер для хранения не найден

Если вы видите ошибку «Указанный контейнер не существует»:

Проверьте имя вашего контейнера в Firebase Console → Storage
Установите правильное имя контейнера в переменной среды FIREBASE_STORAGE_BUCKET

Инициализация Firebase не удалась

Если вы видите ошибку «Firebase не инициализирован»:

Проверьте правильность и полноту пути к ключу учетной записи службы.
Убедитесь, что учетная запись службы имеет необходимые разрешения для служб Firebase.

Требуется составной индекс

Если вы получили сообщение об ошибке «Для этого запроса требуется составной индекс»:

Найдите указанный URL в сообщении об ошибке.
Перейдите по ссылке, чтобы создать необходимый индекс в Firebase Console.
Повторите запрос после создания индекса (это может занять несколько минут)

📋 Форматирование ответа

Пример ответа на загрузку хранилища

{
  "name": "reports/quarterly.pdf",
  "size": "1024000",
  "contentType": "application/pdf",
  "updated": "2025-04-11T15:37:10.290Z",
  "downloadUrl": "https://storage.googleapis.com/bucket/reports/quarterly.pdf?alt=media",
  "bucket": "your-project.appspot.com"
}

Отображается пользователю как:

## File Successfully Uploaded! 📁

Your file has been uploaded to Firebase Storage:

**File Details:**
- **Name:** reports/quarterly.pdf
- **Size:** 1024000 bytes
- **Type:** application/pdf
- **Last Updated:** April 11, 2025 at 15:37:10 UTC

**[Click here to download your file](https://storage.googleapis.com/bucket/reports/quarterly.pdf?alt=media)**

🤝 Вклад

Форк репозитория
Создать ветку функций
Внедрение изменений с помощью тестов (требуется покрытие 80%+)
Отправить запрос на извлечение

📄 Лицензия

Лицензия MIT — подробности см. в файле LICENSE

Integrations