개요

Firebase MCP는 AI 비서가 다음 서비스를 포함한 Firebase 서비스와 직접 작업할 수 있게 합니다:

• Firestore: 문서 데이터베이스 작업
• 스토리지: 강력한 업로드 기능을 갖춘 파일 관리
• 인증: 사용자 관리 및 검증

서버는 Claude Desktop, Augment Code, VS Code, Cursor와 같은 MCP 클라이언트 애플리케이션과 함께 작동합니다.

⚠️ 알려진 문제: firestore_list_collections 도구가 클라이언트 로그에서 Zod 검증 오류를 반환할 수 있습니다. 이는 MCP SDK에서 잘못된 검증 오류로, 조사 결과 응답에 불리언 수가 없다는 것이 확인되었습니다. 오류 메시지에도 불구하고 쿼리는 정상적으로 작동하며 적절한 수집 데이터를 반환합니다. 이는 기능에 영향을 주지 않는 로그 수준 오류입니다.

⚡ 퀵 스타트

전제 조건

• 서비스 계정 자격 증명이 있는 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

Firebase MCP

Overview

Firebase MCP enables AI assistants to work directly with Firebase services, including:

• Firestore: Document database operations
• Storage: File management with robust upload capabilities
• Authentication: User management and verification

The server works with MCP client applicatios such as Claude Desktop, Augment Code, VS Code, and Cursor.

⚠️ Known Issue: The firestore_list_collections tool may return a Zod validation error in the client logs. This is an erroneous validation error in the MCP SDK, as our investigation confirmed no boolean values are present in the response. Despite the error message, the query still works correctly and returns the proper collection data. This is a log-level error that doesn’t affect functionality.

⚡ Quick Start

Prerequisites

• Firebase project with service account credentials
• Node.js environment

1. Install MCP Server

Add the server configuration to your MCP settings file:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
• Augment: ~/Library/Application Support/Code/User/settings.json
• Cursor: [project root]/.cursor/mcp.json

MCP Servers can be installed manually or at runtime via npx (recommended). How you install determines your configuration:

Configure for npx (recommended)

{
  "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"
    }
  }
}

Configure for local installation

{
  "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. Test the Installation

Ask your AI client: “Please test all Firebase MCP tools.”

🛠️ Setup & Configuration

1. Firebase Configuration

1. Go to Firebase Console → Project Settings → Service Accounts
2. Click “Generate new private key”
3. Save the JSON file securely

2. Environment Variables

Required