MCP Uploader CLI

CLI tool for building and deploying React applications with Firebase Google OAuth authentication.

Installation

npm install -g @yahal-even-chen/mcp-uploader

Setup

1. Firebase Configuration

You need to set up Firebase and Google OAuth credentials:

1. Go to Firebase Console
2. Create a new project or select an existing one
3. Get your Firebase API Key from Project Settings
4. Set up Google OAuth in Authentication > Sign-in method
5. Get your Google Client ID from Google Cloud Console

2. Environment Variables

Create a .env file in your project root:

FIREBASE_API_KEY=your-firebase-api-key
GOOGLE_CLIENT_ID=your-google-client-id.apps.googleusercontent.com
UPLOAD_URL=https://your-server.com/upload  # Optional: default deployment URL

Or set them globally:

export FIREBASE_API_KEY=your-firebase-api-key
export GOOGLE_CLIENT_ID=your-google-client-id.apps.googleusercontent.com

Usage

Authentication Commands

# Login with Google account
mcp login

# Check who is logged in
mcp whoami

# Logout
mcp logout

Build & Deploy Commands

# Build your React application
mcp build

# Build and deploy to server
mcp deploy -u https://your-server.com/upload

# Deploy without rebuilding (use existing build)
mcp deploy -u https://your-server.com/upload --skip-build

# Deploy from custom directory
mcp deploy -d /path/to/project -u https://your-server.com/upload

Advanced Commands

# Upload source code to MCP Gateway
mcp push-src -u https://gateway.example.com/src

# Upload build artifacts to MCP Gateway
mcp push-dist -u https://gateway.example.com/dist

How It Works

1. Authentication: Uses Firebase Google OAuth with automatic browser-based login
2. Secure Storage: Stores refresh tokens in your system keychain (Keychain on macOS, Credential Manager on Windows)
3. Auto-refresh: Automatically refreshes expired tokens
4. Build & Pack: Runs npm run build and packs the output into a .tgz archive
5. Upload: Uploads to your server with Firebase ID token authentication

Requirements

• Node.js 14 or higher
• npm or yarn
• A Firebase project with Google OAuth enabled
• A deployment server that accepts Firebase authentication

License

ISC

Author

Yahal Even Chen