django-firebase-mcp

# Django Firebase MCP A comprehensive Django app that implements Firebase Model Context Protocol (MCP) server, enabling AI agents to interact with Firebase services through a standardized protocol. ## 🚀 Quick Start Get up and running in under 5 minutes with the standalone Firebase agent for testing. ### Prerequisites - Python 3.11+ - Firebase project with Admin SDK - Git (optional) - Redis (optional, for persistent state management) ### 1. Clone & Setup ```bash git clone https://github.com/your-repo/django-firebase-mcp.git cd django-firebase-mcp ``` ### 2. Install Dependencies ```bash pip install -r requirements.txt ``` ### 3. Firebase Setup #### Get Firebase Credentials 1. Go to [Firebase Console](https://console.firebase.google.com/) 2. Select your project (or create a new one) 3. Navigate to **Project Settings** → **Service Accounts** 4. Click **"Generate new private key"** 5. Download the JSON file and save it as `credentials.json` in the project root #### Enable Firebase Services Make sure these services are enabled in your Firebase project: - **Authentication** (for user management) - **Firestore Database** (for document storage) - **Cloud Storage** (for file uploads) ### 4. Environment Configuration Create a `.env` file in the project root: ```env # Firebase Configuration SERVICE_ACCOUNT_KEY_PATH=credentials.json FIREBASE_STORAGE_BUCKET=your-project-id.appspot.com # MCP Configuration MCP_TRANSPORT=http MCP_HOST=127.0.0.1 MCP_PORT=8001 # Django Settings DEBUG=True SECRET_KEY=your-secret-key-here ``` **⚠️ Important:** Replace `your-project-id` with your actual Firebase project ID. ### 5. State Management Setup The Firebase MCP agent uses state management for conversation persistence. Choose one option: #### Option A: Redis (Recommended for Production) Install and run Redis on port 6379: ```powershell # Install Redis using Chocolatey choco install redis-64 # Or download from: https://github.com/microsoftarchive/redis/releases # Then …