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

git clone https://github.com/your-repo/django-firebase-mcp.git
cd django-firebase-mcp

2. Install Dependencies

pip install -r requirements.txt

3. Firebase Setup

Get Firebase Credentials

1. Go to Firebase Console
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:

# 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:

# Install Redis using Chocolatey
choco install redis-64

# Or download from: https://github.com/microsoftarchive/redis/releases
# Then run Redis server
redis-server

Add to your .env file:

# Redis Configuration
REDIS_URL=redis://localhost:6379
USE_REDIS=true

Option B: InMemorySaver (Quick Testing)

For quick testing without Redis, the agent will automatically use InMemorySaver. No additional setup required.

Add to your .env file:

# Memory-based state (no persistence)
USE_REDIS=false

Note: InMemorySaver doesn't persist conversations between restarts, while Redis maintains state across sessions.

6. Quick Test with Standalone Agent

Test your setup immediately with the standalone Firebase agent:

# Run the standalone agent
python firebase_admin_mcp/standalone_firebase_agent.py

You should see:

🔥 Firebase MCP Agent Ready!
Type 'help' for available commands, 'quit' to exit.

>

Try these commands:

> List all Firebase collections
> Check Firebase health status
> help
> quit

7. Full Django Setup (Optional)

For full Django integration:

# Apply migrations
python manage.py migrate

# Create superuser (optional)
python manage.py createsuperuser

# Run Django development server
python manage.py runserver 8001

The MCP server will be available at: http://127.0.0.1:8001/mcp/

🛠️ Management Commands

Core Commands

# Run standalone Firebase agent (quick testing)
python firebase_admin_mcp/standalone_firebase_agent.py

# Run MCP server via Django
python manage.py runserver 8001

# Run MCP server in stdio mode (for MCP clients)
python manage.py run_mcp --transport stdio

# Run MCP server in HTTP mode
python manage.py run_mcp --transport http --host 127.0.0.1 --port 8001

# Run standalone agent via Django management command
python manage.py run_standalone_agent

Testing Commands

# Test Firebase connectivity
python firebase_admin_mcp/tests/test_firebase_connection.py

# Test MCP server completeness
python firebase_admin_mcp/tests/test_mcp_complete.py

# Demo Firebase agent
python firebas

... [View full README on GitHub](https://github.com/raghavdasila/django-firebase-mcp#readme)