Firebase MCP

AI 에이전트가 Firebase 백엔드를 완전히 구현하고 관리할 수 있는 MCP(Model Context Protocol) 서버입니다.

Installation

npx -y @jun-b/firebase-mcp --project-id <PROJECT_ID> --key-file <PATH>

Configuration

Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": [
        "-y",
        "@jun-b/firebase-mcp",
        "--project-id",
        "your-project-id",
        "--key-file",
        "/path/to/service-account.json"
      ]
    }
  }
}

Arguments

| Argument | Required | Description | |----------|----------|-------------| | --project-id | Yes | Firebase project ID | | --key-file | No | Path to service account key JSON file. Uses Application Default Credentials if not provided. |

Tools

Firestore (9 tools)

| Tool | Description | |------|-------------| | firestore_add_document | Add document with auto-generated ID | | firestore_set_document | Create/overwrite document with specific ID | | firestore_get_document | Get document by ID | | firestore_update_document | Update specific fields | | firestore_delete_document | Delete document | | firestore_list_documents | List all documents in collection | | firestore_query_documents | Query with filters, ordering, pagination | | firestore_list_collections | List collections/subcollections | | firestore_batch_write | Atomic batch operations |

Authentication (9 tools)

| Tool | Description | |------|-------------| | auth_create_user | Create new user | | auth_get_user | Get user by UID | | auth_get_user_by_email | Get user by email | | auth_update_user | Update user properties | | auth_delete_user | Delete user | | auth_list_users | List all users | | auth_set_custom_claims | Set custom claims for RBAC | | auth_create_custom_token | Create custom auth token | | auth_verify_id_token | Verify ID token |

Storage (8 tools)

| Tool | Description | |------|-------------| | storage_upload_string | Upload string/base64 content | | storage_download_file | Download file (returns base64) | | storage_delete_file | Delete file | | storage_list_files | List files in directory | | storage_get_file_metadata | Get file metadata | | storage_get_signed_url | Generate signed URL | | storage_copy_file | Copy file | | storage_move_file | Move file |

Service Account Setup

1. Go to Firebase Console
2. Select your project
3. Go to Project Settings > Service accounts
4. Click "Generate new private key"
5. Save the JSON file securely
6. Use the path in --key-file argument

License

MIT